# Mr.Bricolage Suggest

## Overview

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

## Description

Live Mr.Bricolage product suggestions for a search keyword or EAN, including title, URL, image, price and currency.

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

## Example Response

### Suggest 'marteau'

```json
{
  "total": 5,
  "results": [
    {
      "url": "https://www.mr-bricolage.fr/marteau-perforateur-rh800-800-w.html",
      "type": "product",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/6/3603745041702_b1_ad04.jpg",
      "price": 92.9,
      "title": "Marteau perforateur rh800 800 w",
      "currency": "EUR"
    },
    {
      "url": "https://www.mr-bricolage.fr/coffret-marteau-burineur-4-burins-pour-compresseur-michelin.html",
      "type": "product",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/8/0/8020119077245_b1_b661.jpg",
      "price": 37.9,
      "title": "Coffret marteau burineur 4 burins pour compresseur - MICHELIN",
      "currency": "EUR"
    },
    {
      "url": "https://www.mr-bricolage.fr/marteau-burineur-1500w-5-5-joules-v2-inventiv.html",
      "type": "product",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/6/3603745041764_b1_1d3c.jpg",
      "price": 92.9,
      "title": "Marteau burineur 1500W 5.5 joules V2 - INVENTIV",
      "currency": "EUR"
    },
    {
      "url": "https://www.mr-bricolage.fr/combine-marteau-brosse.html",
      "type": "product",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/1/3154020044166_a1_da7a.jpg",
      "price": 5.3,
      "title": "Combiné marteau brosse",
      "currency": "EUR"
    },
    {
      "url": "https://www.mr-bricolage.fr/marteau-a-piquer.html",
      "type": "product",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/1/3154020044159_b1_9145.jpg",
      "price": 9.1,
      "title": "Marteau à piquer",
      "currency": "EUR"
    }
  ]
}
```

## Documentation

## Overview
The Mr.Bricolage Suggest endpoint returns live product suggestions from the Mr.Bricolage website for a given search keyword or EAN. Each suggestion includes the product title, public URL, image, price and currency.

## Quickstart
```
GET https://api.piloterr.com/v2/mrbricolage/suggest?query=marteau
GET https://api.piloterr.com/v2/mrbricolage/suggest?query=3283988157233
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search keyword or EAN barcode used against the Mr.Bricolage suggest engine |

## Response fields
| Field | Type | Description |
|---|---|---|
| `total` | integer | Number of products returned in `results` |
| `results` | array | List of product suggestions |
| `results[].type` | string | Always `product` |
| `results[].title` | string | Product title as displayed on Mr.Bricolage |
| `results[].url` | string | Public product URL on `www.mr-bricolage.fr` |
| `results[].image` | string | Product image URL |
| `results[].price` | number | Product price returned by the suggest endpoint |
| `results[].currency` | string | ISO currency code (e.g. `EUR`) |

## Notes
- Only `query` is required; no store identifier is needed
- The endpoint may return `404` when the keyword has no matching product
- For store-specific pricing and stock, use the Mr.Bricolage Product or Product Price endpoints with a `store_id`

## Main use cases
- Build an autocomplete or live search bar for Mr.Bricolage products
- Resolve a generic keyword (e.g. `marteau`) or an EAN into matching product URLs
- Enrich shopping or comparison datasets with Mr.Bricolage product data