Pesquisa de produtos Bricorama em www.bricorama.fr.
query é uma palavra-chave ou um URL /search?q=. A resposta é { results, pagination }. Cada cartão traz o EAN, o nome, a marca, o preço atual e, quando o cartão os mostra, o preço rasurado, o vendedor e a linha de entrega.
Um URL de produto (/p/...) devolve 400.
GET https://api.piloterr.com/v2/bricorama/search?query=perceuse
GET https://api.piloterr.com/v2/bricorama/search?query=perceuse&page=2
GET https://api.piloterr.com/v2/bricorama/search?query=https://www.bricorama.fr/search?q=perceuse
Exemplo (palavra-chave):
perceuse
Exemplo (URL de pesquisa):
https://www.bricorama.fr/search?q=perceuse
query é obrigatório. Só www.bricorama.fr é aceite.
| Forma |
Exemplo |
Efeito |
| Palavra-chave |
perceuse |
Constrói https://www.bricorama.fr/search?q=perceuse. |
| URL de pesquisa |
https://www.bricorama.fr/search?q=perceuse |
Usa essa lista. page acrescenta ou substitui ?page=. |
Um URL de produto devolve 400. Outro host devolve 400. Um valor vazio devolve 400. page inferior a 1 devolve 400.
page começa em 1. A página 2 da mesma lista é ?page=2.
| Parameter |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
Palavra-chave ou URL /search?q= |
page |
integer |
no |
Página a partir de 1. Enviada como ?page= na lista. |
| Campo |
Tipo |
Descrição |
results[] |
array |
Cartões de produto da página |
results[].position |
integer |
Posição na página, a partir de 1 |
results[].ean |
string | null |
EAN do URL do produto |
results[].name |
string |
Nome do produto |
results[].brand |
string | null |
Marca |
results[].url |
string |
URL de produto em /p/ |
results[].image |
string | null |
Imagem principal |
results[].price |
number | null |
Preço atual em euros |
results[].price_display |
string | null |
Preço mostrado, por exemplo 27,90 € |
results[].was_price |
number | null |
Preço rasurado |
results[].was_price_display |
string | null |
Preço rasurado mostrado |
results[].discount_display |
string | null |
Selo de desconto, por exemplo -30% |
results[].currency |
string | null |
EUR quando há preço |
results[].availability |
string | null |
Frase de stock do cartão |
results[].delivery |
string | null |
Linha de levantamento ou envio |
results[].seller |
string | null |
Vendedor marketplace, ou null |
pagination.page |
integer |
Página pedida |
pagination.per_page |
integer |
Cartões devolvidos nesta página |
pagination.total_results |
null |
Não publicado pela página |
pagination.total_pages |
null |
Não publicado pela página |
pagination.next |
string | null |
URL da página seguinte |
price é o preço atual (27.9) e price_display mantém a vírgula francesa (27,90 €).
was_price é o preço rasurado. Fica null quando o cartão não tem desconto.
discount_display é o selo mostrado, por exemplo -30%.
seller é preenchido quando o cartão nomeia um vendedor marketplace. Caso contrário, null.
availability é a frase de stock do cartão, não o stock de uma loja concreta.
A página não publica um total, por isso total_results e total_pages são null. next é o URL da página seguinte.
O exemplo fica com o primeiro cartão. Uma chamada real devolve todos os cartões da página.
- Acompanhar preços de bricolage em França
- Percorrer uma palavra de ferramenta ou tinta
- Passar um URL a Product
| Code |
Significado |
400 |
Pedido vazio, host desconhecido, URL de produto ou page inferior a 1 |
403 |
Bloqueado |
404 |
Nenhum cartão de produto na página |
500 |
Falha do pedido |
Bricorama Produto