Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Bricorama Search

Recherchez sur Bricorama par mot-clé ou URL et parcourez le bricolage.

Actif1 crédit = 1 requêteGET/v2/bricorama/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

Vue d'ensembleLink to Vue d'ensemble

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.

Démarrage rapideLink to Démarrage rapide

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

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ètresLink to Paramètres

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.

Champs de la réponseLink to Champs de la réponse

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

NotesLink to Notes

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.

Cas d'utilisationLink to Cas d'utilisation

  • Suivre les prix bricolage en France
  • Parcourir un mot-clé outillage ou peinture
  • Reprendre une URL dans Product

Codes d'erreurLink to Codes d'erreur

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

Endpoints liésLink to Endpoints liés

Bricorama Produit

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus