# Mr.Bricolage Stores Finder

## Overview

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

## Description

Search Mr.Bricolage stores by name, city or postal code to retrieve their store ID, slug, contact information and geolocation.

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

## Example Response

### Search by city 'matignon'

```json
[
  {
    "id": "58cbe9720cb81d1100996836",
    "epj": "00794246",
    "city": "MATIGNON",
    "name": "Mr.Bricolage Matignon",
    "phone": "+33 2 96 41 16 94",
    "region": "Bretagne",
    "seo_id": "137",
    "store_id": "S727",
    "department": "Côtes-d'Armor",
    "store_slug": "Matignon",
    "postal_code": "22550",
    "country_code": "FR",
    "magento_slug": "mr-bricolage-matignon",
    "live_page_url": "https://magasin.mr-bricolage.fr/137-mr-bricolage-matignon"
  }
]
```

## Documentation

## Overview
The Mr.Bricolage Stores Finder endpoint allows you to search for Piloterr-supported Mr.Bricolage stores in France and overseas territories. It returns an array of stores with their unique identifiers, contact information and geolocation. This endpoint is free to use and is ideal for resolving a Mr.Bricolage store before calling the Mr.Bricolage Suggest or Product APIs with a `store_id` or `store_slug`.

## Quickstart
```
GET https://api.piloterr.com/v2/finder/mrbricolage-stores?query=matignon
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Case-insensitive string to filter store names, cities or postal codes |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Unique internal store identifier |
| `store_id` | string | Mr.Bricolage store ID, usable in the Mr.Bricolage Suggest API |
| `store_slug` | string | URL slug of the store on `www.mr-bricolage.fr`, usable in the Mr.Bricolage Suggest API |
| `magento_slug` | string | Magento URL slug used internally by Mr.Bricolage |
| `seo_id` | string | Numeric SEO identifier of the store |
| `name` | string | Store name |
| `city` | string | Store city |
| `postal_code` | string | Store postal code |
| `country_code` | string | ISO country code (FR, MU, etc.) |
| `region` | string | Region the store belongs to (e.g. Bretagne) |
| `department` | string | French department name (e.g. Côtes-d'Armor) |
| `phone` | string | Store phone number in international format |
| `epj` | string | EPJ accounting identifier of the store |
| `live_page_url` | string | Public URL of the store locator page |

## Notes
- Both `store_id` and `store_slug` can be passed to the Mr.Bricolage Suggest API; you only need to provide one
- Stores cover Metropolitan France and overseas territories (Guadeloupe, Martinique, Guyane, Réunion, Mayotte, Mauritius)
- The search is case-insensitive

## Main use cases
- Locate the nearest Mr.Bricolage store by city name before fetching local suggestions or products
- Resolve store names to IDs or slugs for use in the Mr.Bricolage Suggest API
- Build store locator features for French DIY retail applications
- Enrich datasets with Mr.Bricolage store geolocation, contact details and identifiers