Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API Bricorama Search

Pesquise no Bricorama por palavra ou URL e percorra o bricolage.

Ativo1 crédito = 1 requisiçãoGET/v2/bricorama/search

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

Visão geralLink to Visão geral

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.

Início rápidoLink to Início rápido

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

queryLink to query

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.

ParâmetrosLink to Parâmetros

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.

Campos da respostaLink to Campos da resposta

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

NotasLink to Notas

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.

Casos de usoLink to Casos de uso

  • Acompanhar preços de bricolage em França
  • Percorrer uma palavra de ferramenta ou tinta
  • Passar um URL a Product

Códigos de erroLink to Códigos de erro

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

Endpoints relacionadosLink to Endpoints relacionados

Bricorama Produto

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos