Europages supplier profile. 1 credit per call.
query is a profile URL (/fr/company/{slug-id}), an older listing URL (/NAME/….html), or the slug itself. The object includes the address, supplier types, delivery area, description, website, categories, and the products listed on that profile (products).
A product URL (/products/) returns 400.
GET https://api.piloterr.com/v2/europages/company?query=https://www.europages.fr/fr/company/synyco-sas-22106635
GET https://api.piloterr.com/v2/europages/company?query=synyco-sas-22106635
Example (slug):
synyco-sas-22106635
Example (company URL):
https://www.europages.fr/fr/company/synyco-sas-22106635
query is required.
| Form |
Example |
What happens |
| Profile URL |
https://www.europages.fr/fr/company/synyco-sas-22106635 |
Path contains /company/. The host must be a Europages site |
| Legacy profile URL |
https://www.europages.fr/SYNYCO/00000005432611-001.html |
Two path segments, the last one ends in .html and contains a numeric id |
| Slug |
synyco-sas-22106635 |
No space and no slash. Built as https://{host}/{language}/company/{slug} with domain |
A product URL (/products/) returns 400. A category or search URL returns 400. A name with spaces returns 400: search first, then pass results[].url. Another host returns 400. An empty value returns 400.
domain applies only to a slug. Same values as search (fr by default, de, co.uk, es, …). It is ignored when query is a URL.
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
/company/ URL, legacy /NAME/….html URL, or a slug without spaces |
domain |
string |
no |
Site when query is a slug. Default fr |
| Field |
Type |
Description |
company_id |
string | null |
Numeric id |
name |
string |
Legal or display name |
url |
string |
Profile URL |
country |
string | null |
Country |
address |
object |
street, postal_code, city, formatted |
supplier_types |
string[] |
Supplier roles |
delivery_area |
string | null |
Delivery area |
description |
string | null |
About text |
website |
string | null |
Company website |
categories |
string[] |
Product categories |
products[] |
array |
Products listed on the profile |
products[].name |
string | null |
Product name |
products[].url |
string |
Product page URL |
products[].price |
number | null |
Numeric price |
products[].price_display |
string | null |
Price as shown |
products[].currency |
string | null |
EUR, GBP or USD when the symbol is present |
products[].minimum_order_quantity |
string | null |
Minimum order |
products are only the products of this company, not recommendations.
- An unknown profile returns
404.
| Code |
Meaning |
400 |
Missing query, unknown host, or a product URL |
403 |
Blocked |
404 |
Company not found |
500 |
Fetch failed |