Búsqueda de proveedores Europages. 1 crédito por llamada.
query es una palabra clave o una URL de categoría / búsqueda. domain elige el sitio (fr por defecto). page usa /pg-N/.
Respuesta: { results, pagination }. 30 empresas por página.
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
Ejemplo (palabra clave):
embalaje
Ejemplo (URL de búsqueda):
https://www.europages.es/empresas/embalaje.html
query es obligatorio.
| Forma |
Ejemplo |
Efecto |
| Palabra clave |
embalaje |
Búsqueda en el sitio de domain. Por defecto https://www.europages.fr/fr/search/embalaje |
| URL de categoría o de búsqueda |
https://www.europages.es/empresas/embalaje.html |
El host se conserva. Una URL de empresa o de producto devuelve 400 |
Otro host devuelve 400. Un valor vacío devuelve 400.
domain es el sitio de una palabra clave. Valores: fr (por defecto), de, co.uk (también 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. Se ignora si query es una URL. El alemán usa la ruta /de/suche/. Un valor desconocido devuelve 400.
page empieza en 1. Por debajo de 1: 400. La página 2 y las siguientes usan /pg-N/ en la URL del listado. Una página tiene 30 empresas.
| Parámetro |
Tipo |
Obligatorio |
Descripción |
query |
string |
sí |
Palabra clave, o URL de categoría / búsqueda Europages |
domain |
string |
no |
Sitio de una palabra clave, por ejemplo fr, de, co.uk. Por defecto fr |
page |
integer |
no |
Página desde 1. Las siguientes usan /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 |
- Una URL de ficha o de producto devuelve
400. Use Europages Company.
- Las fichas antiguas enlazan a
/NOMBRE/….html. company_id es el número de esa URL. Europages Company la acepta y devuelve el id actual de la página.
- Sin tarjetas devuelve
404.
| Código |
Significado |
400 |
Consulta vacía, host desconocido o URL de ficha / producto |
403 |
Bloqueado |
404 |
Ningún proveedor |
500 |
Fallo de la petición |
