Pesquisa de fornecedores Europages. 1 crédito por chamada.
query é uma palavra-chave ou um URL de categoria / pesquisa. domain escolhe o site (fr por predefinição). page usa /pg-N/.
Resposta: { 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
Exemplo (palavra-chave):
embalagem
Exemplo (URL de pesquisa):
https://www.europages.pt/empresas/embalagem.html
query é obrigatório.
| Forma |
Exemplo |
Efeito |
| Palavra-chave |
embalagem |
Pesquisa no site de domain. Predefinição https://www.europages.fr/fr/search/embalagem |
| URL de categoria ou de pesquisa |
https://www.europages.pt/empresas/embalagem.html |
O host mantém-se. Um URL de empresa ou de produto devolve 400 |
Outro host devolve 400. Um valor vazio devolve 400.
domain é o site de uma palavra-chave. Valores: fr (predefinição), de, co.uk (também 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. Ignora-se se query for um URL. O alemão usa o caminho /de/suche/. Um valor desconhecido devolve 400.
page começa em 1. Abaixo de 1: 400. A página 2 e as seguintes usam /pg-N/ no URL da lista. Uma página tem 30 empresas.
| Parâmetro |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
Palavra-chave, ou URL de categoria / pesquisa Europages |
domain |
string |
não |
Site de uma palavra-chave, por exemplo fr, de, co.uk. Predefinição fr |
page |
integer |
não |
Página a partir de 1. As seguintes usam /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 |
- Um URL de ficha ou de produto devolve
400. Use Europages Company.
- As fichas antigas apontam para
/NOME/….html. company_id é o número desse URL. Europages Company aceita-o e devolve o id atual da página.
- Sem cartões devolve
404.
| Código |
Significado |
400 |
Pedido vazio, host desconhecido ou URL de ficha / produto |
403 |
Bloqueado |
404 |
Nenhum fornecedor |
500 |
Falha do pedido |
