Recherche produit Bricorama sur www.bricorama.fr.
query est un mot-clé ou une URL /search?q=. La réponse est { results, pagination }. Chaque carte a l'EAN, le nom, la marque, le prix courant et, quand la carte les affiche, le prix barré, le vendeur et la ligne de livraison.
Une URL produit (/p/...) renvoie 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
Exemple (mot-clé):
perceuse
Exemple (URL de recherche):
https://www.bricorama.fr/search?q=perceuse
query est obligatoire. Seul www.bricorama.fr est accepté.
| Forme |
Exemple |
Effet |
| Mot-clé |
perceuse |
Construit https://www.bricorama.fr/search?q=perceuse. |
| URL de recherche |
https://www.bricorama.fr/search?q=perceuse |
Utilise cette liste. page ajoute ou remplace ?page=. |
Une URL produit renvoie 400. Un autre hôte renvoie 400. Une valeur vide renvoie 400. page inférieur à 1 renvoie 400.
page commence à 1. La page 2 de la même liste est ?page=2.
| Paramètre |
Type |
Obligatoire |
Description |
query |
string |
oui |
Mot-clé ou URL /search?q= |
page |
integer |
non |
Page à partir de 1. Envoyée comme ?page= sur la liste. |
| Champ |
Type |
Description |
results[] |
array |
Cartes produit de la page |
results[].position |
integer |
Position sur la page, à partir de 1 |
results[].ean |
string | null |
EAN tiré de l'URL produit |
results[].name |
string |
Nom du produit |
results[].brand |
string | null |
Marque |
results[].url |
string |
URL produit sous /p/ |
results[].image |
string | null |
Image principale |
results[].price |
number | null |
Prix courant en euros |
results[].price_display |
string | null |
Prix affiché, par exemple 27,90 € |
results[].was_price |
number | null |
Prix barré |
results[].was_price_display |
string | null |
Prix barré affiché |
results[].discount_display |
string | null |
Badge de remise, par exemple -30% |
results[].currency |
string | null |
EUR quand un prix est présent |
results[].availability |
string | null |
Phrase de stock de la carte |
results[].delivery |
string | null |
Ligne de retrait ou de livraison |
results[].seller |
string | null |
Vendeur marketplace, ou null |
pagination.page |
integer |
Page demandée |
pagination.per_page |
integer |
Cartes renvoyées sur cette page |
pagination.total_results |
null |
Non publié par la page |
pagination.total_pages |
null |
Non publié par la page |
pagination.next |
string | null |
URL de la page suivante |
price est le prix courant (27.9) et price_display garde la virgule française (27,90 €).
was_price est le prix barré. Il vaut null quand la carte n'a pas de remise.
discount_display est le badge affiché, par exemple -30%.
seller est rempli quand la carte nomme un vendeur marketplace. Il vaut null pour Bricorama.
availability est la phrase de stock de la carte. Ce n'est pas le stock d'un magasin précis.
La page ne publie pas de total, donc total_results et total_pages valent null. next est l'URL de la page suivante.
L'exemple garde la première carte. Un appel réel renvoie toutes les cartes de la page.
- Suivre les prix bricolage en France
- Parcourir un mot-clé outillage ou peinture
- Reprendre une URL dans Product
| Code |
Signification |
400 |
Requête vide, hôte inconnu, URL produit, ou page inférieur à 1 |
403 |
Bloqué |
404 |
Aucune carte produit sur la page |
500 |
Échec de la récupération |
Bricorama Produit