# Bricorama Product ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/bricorama/product` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/bricorama-product | ## Description Read one Bricorama product from its URL. You get price, brand, and the product details. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/bricorama/product' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Perceuse visseuse sans fil 18V ```json { "ean": "3999991691267", "url": "https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267", "name": "Perceuse visseuse sans fil 18V", "brand": "GO/ON", "price": 27.9, "images": [ "https://assets-big.cdn-mousquetaires.com/medias/domain11440/media2624/393739-2ftpvnauip-epreview.jpg" ], "currency": "EUR", "delivery": "Retrait en 2h en magasin", "was_price": null, "description": "Découvrez la perceuse visseuse sans fil 18V de la marque GO/ON, un outil performant et pratique conçu pour faciliter tous vos travaux de perçage et de vissage, que vous soyez un bricoleur novice ou expérimenté. Cette perceuse visseuse est équipée d'une batterie Lithium-ion de 1300mAh offrant une bonne autonomie et un temps de charge rapide de seulement 3 heures. Sa puissance de 18 volts assure une efficacité optimale pour une large variété de tâches. Elle dispose d'un mandrin sans clé de 10 mm, ce qui permet un changement rapide et facile des embouts. Grâce à sa fonction réversible et sa vitesse variable, vous pouvez adapter la puissance et la rotation selon vos besoins, pour un contrôle précis et un travail soigné. Le réglage de couple est particulièrement pratique avec 21+1 positions et une force maximale de 16 Nm, ce qui permet de travailler sur différents matériaux sans risque d'endommager les vis ou la surface. Cette perceuse est capable de percer jusqu'à 10 mm dans l'acier et 25 mm dans le bois, ce qui la rend idéale pour des travaux de bricolage courants, comme la fixation d'étagères, le montage de meubles ou la réalisation de petits travaux de construction. Compacte et légère, elle offre une bonne prise en main grâce à sa poignée ergonomique, ce qui limite la fatigue lors d'une utilisation prolongée. Son design sans fil apporte une grande liberté de mouvement et facilite l'accès aux endroits difficiles d'accès sans contrainte de câble. Caractéristiques : Perceuse visseuse sans fil Puissance : 18V Batterie Lithium-ion 1300mAh Chargeur 3 heures Réversible Vitesse variable Mandrin sans clé 10 mm Réglage de couple 16 Nm, 21+1 positions Capacité de perçage acier : 10 mm Capacité de perçage bois : 25 mm GO/ON est une marque reconnue pour son savoir-faire dans la fabrication d’outils électroportatifs destinés aux bricoleurs. Elle allie performance, robustesse et simplicité d’utilisation pour proposer des produits adaptés aux besoins de tous, du novice au plus expérimenté, facilitant ainsi la réalisation de travaux de bricolage variés.", "price_display": "27,90 €", "specifications": [ { "name": "Marque", "value": "GO/ON" }, { "name": "Éclairage intégré", "value": "Non" }, { "name": "Vitesse variable", "value": "Oui" }, { "name": "Diamètre de perçage dans le bois (en mm)", "value": "25" }, { "name": "Diamètre de perçage dans le métal (en mm)", "value": "10" }, { "name": "Type de produit", "value": "Perceuse visseuse" }, { "name": "Hauteur du produit déballé", "value": "7 cm" }, { "name": "Largeur du produit déballé", "value": "19 cm" }, { "name": "Profondeur du produit déballé", "value": "20 cm" }, { "name": "Poids du produit déballé", "value": "1.3 kg" }, { "name": "Disponibilité des pièces détachées", "value": "Non communiquée" }, { "name": "Hauteur du produit emballé", "value": "20.3 cm" }, { "name": "Largeur du produit emballé", "value": "8.5 cm" }, { "name": "Profondeur du produit emballé", "value": "21.3 cm" }, { "name": "Poids du produit emballé", "value": "1.3 kg" }, { "name": "Références produit", "value": "25077430 / 3999991691267" } ], "discount_display": null, "was_price_display": null } ``` ## Documentation ## Overview **Bricorama** product page on www.bricorama.fr. `query` is a product URL `/p/{slug}/{ean}`. The response is one flat object: EAN, name, brand, description, price, images and the specification list. A keyword or a `/search` URL returns `400`. ## Quickstart ``` GET https://api.piloterr.com/v2/bricorama/product?query=https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267 ``` ## `query` **Example (product URL):** https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267 `query` is required. Only `www.bricorama.fr` is accepted. | Form | Example | What happens | |---|---|---| | Product URL | `https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267` | Product page. The path is `/p/{slug}/{ean}`. | A keyword returns `400`. A search URL returns `400`. Another host returns `400`. An empty value returns `400`. ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Product URL `/p/{slug}/{ean}` | ## Response fields | Field | Type | Description | |---|---|---| | `ean` | string \| null | GTIN-13 | | `name` | string | Product name | | `brand` | string \| null | Brand | | `url` | string | Product URL | | `description` | string \| null | Description | | `price` | number \| null | Current offer price | | `price_display` | string \| null | Price as shown | | `was_price` | number \| null | Crossed-out price | | `was_price_display` | string \| null | Crossed-out price as shown | | `discount_display` | string \| null | Discount badge when the offer has one | | `currency` | string \| null | `EUR` | | `delivery` | string \| null | Pickup or shipping line | | `images` | string[] | Image URLs | | `specifications` | array | Rows `{ name, value }` | ## Notes The price comes from the offer block on the page. `was_price` is set when that offer has a crossed-out price. `delivery` is the pickup or shipping line, such as `Retrait en 2h en magasin`. `brand` prefers the `Marque` row of the specification list. Store stock depends on the shop. This endpoint does not look up a store. ## Main use cases - Open the sheet behind a search card - Store the selling price - Collect brand and specifications ## Error codes | Code | Meaning | |---|---| | `400` | Empty query, unknown host, or a search URL | | `403` | Blocked | | `404` | Product page not found | | `500` | Fetch failed | ## Related endpoints [Bricorama Search](https://www.piloterr.com/library/bricorama-search)