Recherche de fournisseurs Europages. 1 crédit par appel.
query est un mot-clé (emballage) ou une URL de catégorie / recherche. domain choisit le site pays pour un mot-clé (fr par défaut). page suit la pagination /pg-N/.
Réponse : { results, pagination }. Une page contient 30 sociétés.
GET https://api.piloterr.com/v2/europages/search?query=emballage
GET https://api.piloterr.com/v2/europages/search?query=https://www.europages.fr/entreprises/emballage-blister-plastique.html&page=2
Exemple (mot-clé) :
emballage
Exemple (URL de recherche) :
https://www.europages.fr/entreprises/emballage-blister-plastique.html
query est obligatoire.
| Forme |
Exemple |
Effet |
| Mot-clé |
emballage |
Recherche sur le site choisi par domain. Défaut https://www.europages.fr/fr/search/emballage |
| URL de catégorie ou de recherche |
https://www.europages.fr/entreprises/emballage-blister-plastique.html |
L'hôte est conservé. Une URL de société ou de produit renvoie 400 |
Un autre hôte renvoie 400. Une valeur vide renvoie 400.
domain est le site d'un mot-clé. Valeurs : fr (défaut), de, co.uk (aussi en, uk, gb), es, it, nl, com.tr (tr), cz (cs), dk, ee, gr, lt, co.hu, no, pl, pt, ro, si, fi, se, bg. Il est ignoré si query est une URL. L'allemand utilise le chemin /de/suche/. Une valeur inconnue renvoie 400.
page part de 1. En dessous de 1 : 400. La page 2 et les suivantes utilisent /pg-N/ sur l'URL de liste. Une page contient 30 sociétés.
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
Mot-clé, ou URL de catégorie / recherche Europages |
domain |
string |
non |
Site d'un mot-clé, par exemple fr, de, co.uk. Défaut fr |
page |
integer |
non |
Page à partir de 1. Les suivantes utilisent /pg-N/ |
| Field |
Type |
Description |
results[] |
array |
Company cards |
results[].position |
integer |
Position on the page, from 1 |
results[].company_id |
string | null |
Numeric id from the profile URL |
results[].name |
string |
Company name |
results[].url |
string |
Profile URL for the company endpoint |
results[].country |
string | null |
Country |
results[].city |
string | null |
City |
results[].founding_year |
integer | null |
Year on the card |
results[].employees |
string | null |
Range such as 20-49 |
results[].delivery_area |
string | null |
Delivery area |
results[].supplier_types |
string[] |
Manufacturer, wholesaler, and similar labels |
results[].description |
string | null |
Short text |
pagination.page / per_page |
integer |
Page and page size (30) |
pagination.total_results / total_pages |
integer | null |
Totals when the page shows them |
pagination.next |
string | null |
Next page URL |
- Une URL de fiche ou de produit renvoie
400. Utilisez Europages Company.
- Les anciennes cartes pointent vers
/NOM/….html. company_id est le numéro dans cette URL. Europages Company l'accepte et renvoie l'identifiant actuel de la page.
- Aucune carte renvoie
404.
- En allemand le chemin est
/de/suche/{mot}. Les autres sites utilisent /{langue}/search/{mot}.
| Code |
Signification |
400 |
Requête vide, hôte inconnu, ou URL de fiche / produit |
403 |
Accès bloqué |
404 |
Aucun fournisseur |
500 |
Échec du fetch |
