# Mr.Bricolage Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/mrbricolage/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 3 credits per call |
| **Documentation** | https://www.piloterr.com/library/mrbricolage-product |

## Description

Scrape a Mr.Bricolage product page and return its details, characteristics, repairability index and customer reviews scoped to a specific store.

## 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/mrbricolage/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Product 'Cisaille à tôle INVENTIV' in store S727 (Matignon)

```json
{
  "ean": "3603743403670",
  "url": "https://www.mr-bricolage.fr/Matignon/cisaille-a-tole-coupe-diagonale-chrome-vanadium-inventiv.html",
  "brand": "INVENTIV",
  "title": "Cisaille à tôle coupe diagonale chrome vanadium - INVENTIV",
  "images": [
    "https://www.mr-bricolage.fr/fstrz/r/s/media.mr-bricolage.fr/media/catalog/product/cache/e8ef490eea298aa9ebc87f5a1985ea16/3/6/3603743403670_b1_088b.jpg",
    "https://www.mr-bricolage.fr/fstrz/r/s/media.mr-bricolage.fr/media/catalog/product/cache/20b8f5320955f3ebb02bf687f8cb2d8f/3/6/3603743403670_b1_088b.jpg",
    "https://media.mr-bricolage.fr/media/catalog/product/3/6/3603743403670_b1_088b.jpg",
    "https://media.mr-bricolage.fr/media/catalog/product/3/6/3603743403670_b2_efc9.JPG"
  ],
  "rating": {
    "max": 5,
    "count": 2,
    "value": 5
  },
  "category": "Outillage/Outillage à main/Pinces et tenailles",
  "warranty": [
    {
      "label": "Garantie légale de conformité",
      "value": "2 ans"
    },
    {
      "label": "Garantie commerciale",
      "value": "Garantie à vie"
    }
  ],
  "product_id": "7117",
  "description": "Cisaille à tôle coupe diagonale d'Inventiv en chrome vanadium. Garantie à vie.",
  "category_path": [
    "Outillage",
    "Outillage à main",
    "Pinces et tenailles"
  ],
  "characteristics": {
    "Marque": "INVENTIV",
    "Poids (kg)": "0.389",
    "Réf. ANPF": "340367",
    "Réf. fabricant": "1001130",
    "Produit phytosanitaire": "Non",
    "Avec isolation électrique": "Non"
  }
}
```

## Documentation

## Overview
The Mr.Bricolage Product endpoint scrapes a product page from `www.mr-bricolage.fr` and returns its full details: title, brand, EAN, repairability index, images, description, characteristics, warranty, tips, documentation and customer reviews. A `store_id` is required: the URL is rewritten to the matching store and the multistore cookie is set so the page is rendered in the context of that store.

For live pricing, stock, eco-participation, loyalty points and delivery options use the dedicated [Mr.Bricolage Product Price](https://app.piloterr.com/library/mrbricolage-product-price) endpoint, which is faster and cheaper.

## Quickstart
```
GET https://api.piloterr.com/v2/mrbricolage/product?url=https://www.mr-bricolage.fr/Matignon/cisaille-a-tole-coupe-diagonale-chrome-vanadium-inventiv.html&store_id=S727
```

Any path prefix in the URL is ignored: a city (e.g. `/Matignon/`, `/Villefranche-de-Lauragais/`), a category, or no prefix at all are all accepted. Only the final `.html` slug is kept and the URL is automatically rewritten under the requested `store_id`. The three URLs below are equivalent:
```
https://www.mr-bricolage.fr/Matignon/cisaille-a-tole-coupe-diagonale-chrome-vanadium-inventiv.html
```

```
https://www.mr-bricolage.fr/Villefranche-de-Lauragais/cisaille-a-tole-coupe-diagonale-chrome-vanadium-inventiv.html
```

```
https://www.mr-bricolage.fr/cisaille-a-tole-coupe-diagonale-chrome-vanadium-inventiv.html
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `url` | string | yes | Mr.Bricolage product page URL (must end with `.html`) |
| `store_id` | string | yes | Mr.Bricolage store identifier (e.g. `S727`). Use the Mr.Bricolage Stores Finder endpoint to find one |

## Response fields
| Field | Type | Description |
|---|---|---|
| `url` | string | Final URL fetched (rewritten to the requested store) |
| `product_id` | string | Internal Mr.Bricolage product ID (Magento entity id) |
| `ean` | string | EAN / GTIN of the product |
| `title` | string | Product title |
| `brand` | string | Brand of the product |
| `category` | string | Full category path joined with `/` |
| `category_path` | array | Category breadcrumb as an array |
| `repairability_index` | number | French repairability index (out of 10) when displayed |
| `rating` | object | `value`, `max` and `count` of customer reviews |
| `images` | array | High-resolution and thumbnail image URLs |
| `description` | string | Plain-text product description |
| `description_html` | string | Original HTML of the product description |
| `advantages` | array | Bullet points of product highlights ("Les plus produit") |
| `characteristics` | object | Map of technical attribute name to value |
| `warranty` | array | Warranty entries with `label` and `value` |
| `tips` | string | Plain-text usage tips |
| `tips_html` | string | Original HTML of the usage tips |
| `documentation` | array | PDF documents attached to the product (`label`, `url`) |
| `reviews` | array | Customer reviews with `rating`, `text`, `author`, `review_date` and `experience_date` |

## Notes
- This endpoint does not return price, stock, delivery or eco-participation data; use the dedicated [Mr.Bricolage Product Price](https://app.piloterr.com/library/mrbricolage-product-price) endpoint for those
- A `store_id` is required because Mr.Bricolage scopes the page content (availability, characteristics) to the selected store
- Most fields can be `null` if not present on the product page

## Main use cases
- Enrich a product catalog with characteristics, EAN, brand and images
- Aggregate customer reviews and ratings for analysis
- Track repairability index and warranty information across Mr.Bricolage stores
- Pair with the Mr.Bricolage Product Price endpoint to build a full product/pricing pipeline