Saltar al contenido principal
Piloterr
Volver a la biblioteca

API de Bricorama Search

Busque en Bricorama por palabra o URL y recorra el bricolaje.

Activo1 crédito = 1 solicitudGET/v2/bricorama/search

Resumen del Endpoint

Documentación detallada, precios y ejemplos de uso.

Descripción generalLink to Descripción general

Búsqueda de productos Bricorama en www.bricorama.fr.

query es una palabra clave o una URL /search?q=. La respuesta es { results, pagination }. Cada ficha trae el EAN, el nombre, la marca, el precio actual y, cuando la ficha los muestra, el precio tachado, el vendedor y la línea de entrega.

Una URL de producto (/p/...) devuelve 400.

Inicio rápidoLink to Inicio 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

Ejemplo (palabra clave):

perceuse

Ejemplo (URL de búsqueda):

https://www.bricorama.fr/search?q=perceuse

query es obligatorio. Solo se acepta www.bricorama.fr.

Forma Ejemplo Efecto
Palabra clave perceuse Construye https://www.bricorama.fr/search?q=perceuse.
URL de búsqueda https://www.bricorama.fr/search?q=perceuse Usa ese listado. page añade o sustituye ?page=.

Una URL de producto devuelve 400. Otro host devuelve 400. Un valor vacío devuelve 400. page menor que 1 devuelve 400.

page empieza en 1. La página 2 del mismo listado es ?page=2.

ParámetrosLink to Parámetros

Parameter Tipo Obligatorio Descripción
query string sí Palabra clave o URL /search?q=
page integer no Página desde 1. Se envía como ?page= en el listado.

Campos de la respuestaLink to Campos de la respuesta

Campo Tipo Descripción
results[] array Fichas de producto de la página
results[].position integer Posición en la página, desde 1
results[].ean string | null EAN de la URL del producto
results[].name string Nombre del producto
results[].brand string | null Marca
results[].url string URL de producto bajo /p/
results[].image string | null Imagen principal
results[].price number | null Precio actual en euros
results[].price_display string | null Precio mostrado, por ejemplo 27,90 €
results[].was_price number | null Precio tachado
results[].was_price_display string | null Precio tachado mostrado
results[].discount_display string | null Etiqueta de descuento, por ejemplo -30%
results[].currency string | null EUR cuando hay precio
results[].availability string | null Frase de stock de la ficha
results[].delivery string | null Línea de recogida o envío
results[].seller string | null Vendedor marketplace, o null
pagination.page integer Página pedida
pagination.per_page integer Fichas devueltas en esta página
pagination.total_results null No publicado por la página
pagination.total_pages null No publicado por la página
pagination.next string | null URL de la página siguiente

NotasLink to Notas

price es el precio actual (27.9) y price_display conserva la coma francesa (27,90 €). was_price es el precio tachado. Vale null cuando la ficha no tiene descuento. discount_display es la etiqueta mostrada, por ejemplo -30%. seller se rellena cuando la ficha nombra un vendedor marketplace. Si no, null. availability es la frase de stock de la ficha, no el stock de una tienda concreta. La página no publica un total, así que total_results y total_pages son null. next es la URL de la página siguiente. El ejemplo conserva la primera ficha. Una llamada real devuelve todas las fichas de la página.

Casos de usoLink to Casos de uso

  • Seguir precios de bricolaje en Francia
  • Recorrer una palabra de herramienta o pintura
  • Pasar una URL a Product

Códigos de errorLink to Códigos de error

Code Significado
400 Consulta vacía, host desconocido, URL de producto o page menor que 1
403 Bloqueado
404 Ninguna ficha de producto en la página
500 Fallo de la petición

Endpoints relacionadosLink to Endpoints relacionados

Bricorama Producto

APIs relacionadas

Amplía tus capacidades de datos con estas herramientas complementarias.

¿Listo para empezar?

Tu API de web scraping está a un clic. Comienza con +500 créditos, sin infraestructura que configurar, sin proxies que gestionar y sin necesidad de tarjeta de crédito.

  • +500 créditos
  • Sin tarjeta de crédito
  • Todos los endpoints incluidos