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.
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
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.
| 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. |
| 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 |
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.
- Seguir precios de bricolaje en Francia
- Recorrer una palabra de herramienta o pintura
- Pasar una URL a Product
| 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 |
Bricorama Producto