Ficha de fornecedor Europages. 1 crédito por chamada.
query é um URL de ficha (/company/… ou antigo /NOME/….html) ou o slug. products são os produtos dessa ficha. Um URL /products/ devolve 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
Exemplo (slug):
synyco-sas-22106635
Exemplo (URL de ficha):
https://www.europages.fr/fr/company/synyco-sas-22106635
query é obrigatório.
| Forma |
Exemplo |
Efeito |
| URL de ficha |
https://www.europages.fr/fr/company/synyco-sas-22106635 |
O caminho contém /company/. O host tem de ser um site Europages |
| URL antigo |
https://www.europages.fr/SYNYCO/00000005432611-001.html |
Dois segmentos, o último acaba em .html e contém um id numérico |
| Slug |
synyco-sas-22106635 |
Sem espaço nem barra. Constrói-se https://{host}/{língua}/company/{slug} com domain |
Um URL de produto (/products/) devolve 400. Um URL de categoria ou de pesquisa devolve 400. Um nome com espaços devolve 400: pesquise primeiro e passe results[].url. Outro host devolve 400. Um valor vazio devolve 400.
domain só se aplica a um slug. Os mesmos valores da pesquisa (fr por predefinição, de, co.uk, es, …). Ignora-se se query for um URL.
| Parâmetro |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
URL /company/, URL antigo /NOME/….html, ou slug sem espaços |
domain |
string |
não |
Site se query for um slug. Predefinição 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 inclui apenas os produtos desta empresa.
- Uma ficha desconhecida devolve
404.
| Código |
Significado |
400 |
Pedido vazio, host desconhecido ou URL de produto |
403 |
Bloqueado |
404 |
Empresa não encontrada |
500 |
Falha do pedido |