# Leroy Merlin Stores Finder

## Overview

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

## Description

Search Leroy Merlin stores by name, city or postal code to retrieve their store ID, slug, address and store locator URL.

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

## Example Response

### Search by city 'Balma'

```json
[
  {
    "id": "110",
    "url": "https://www.leroymerlin.fr/magasins/balma-toulouse.html",
    "city": "Balma",
    "name": "Balma - Toulouse",
    "domain": "fr",
    "address": "1 avenue Jean-René Lagasse, 31130 Balma",
    "store_id": "110",
    "store_slug": "balma-toulouse",
    "postal_code": "31130",
    "country_code": "FR"
  }
]
```

## Documentation

## Overview
The Leroy Merlin Stores Finder endpoint allows you to search for Piloterr-supported Leroy Merlin stores by country (France `FR`, Romania `RO` when indexed). It returns an array of stores with their unique identifiers, address and store locator URL. This endpoint is free to use and is ideal for resolving a Leroy Merlin store before calling the Leroy Merlin Search or Product APIs with a `store_id` or `store_slug`.

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

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

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Unique internal store identifier |
| `store_id` | string | Leroy Merlin store ID, usable in the Leroy Merlin APIs |
| `store_slug` | string | URL slug of the store on `www.leroymerlin.fr/magasins/<slug>.html` |
| `name` | string | Store name as displayed on Leroy Merlin |
| `city` | string | Store city |
| `postal_code` | string | Store postal code |
| `address` | string | Full postal address of the store |
| `url` | string | Public URL of the store information page on `www.leroymerlin.fr` |
| `country_code` | string | ISO country code (e.g. `FR`) |
| `domain` | string | Country domain of the store (`fr`) |

## Notes
- Both `store_id` and `store_slug` can be used as identifiers; you only need one
- Stores cover Metropolitan France and overseas territories (Guadeloupe, Martinique, Guyane, Réunion, Mayotte)
- The search is case-insensitive

## Main use cases
- Locate the nearest Leroy Merlin store by city name before fetching local availability or pricing
- Resolve store names to IDs or slugs for use in the Leroy Merlin APIs
- Build store locator features for French DIY retail applications
- Enrich datasets with Leroy Merlin store address and identifiers