# Leroy Merlin Search

## Overview

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

## Description

Live Leroy Merlin search across France and Romania: title, URL, price, currency, brand, seller, rating and pagination.

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

## Example Response

### Search 'colle pvc' (page 1)

```json
{
  "total": 21,
  "region": "fr",
  "results": [
    {
      "sku": "67806074",
      "url": "https://www.leroymerlin.fr/produits/colle-assemblage-gel-604202-axton-250ml-250-g-transparent-67806074.html",
      "brand": "AXTON",
      "price": 6.99,
      "title": "Colle d'assemblage gel 604202 AXTON, 250ml, 250 g transparent",
      "rating": 4.5,
      "seller": {
        "name": "Leroy Merlin",
        "type": "1P"
      },
      "currency": "EUR",
      "position": 1,
      "is_sponsored": false,
      "price_excl_tax": 5.83,
      "total_offer_count": 1
    },
    {
      "sku": "67805850",
      "url": "https://www.leroymerlin.fr/produits/colle-en-tube-pvc-axton-60-ml-67805850.html",
      "brand": "AXTON",
      "price": 3.59,
      "title": "Colle en tube PVC AXTON, 60 ml",
      "rating": 4.4,
      "seller": {
        "name": "Leroy Merlin",
        "type": "1P"
      },
      "currency": "EUR",
      "position": 2,
      "is_sponsored": false,
      "marketing_tag": "RESPONSIBLE",
      "price_excl_tax": 2.99,
      "total_offer_count": 1
    },
    {
      "sku": "82345671",
      "url": "https://www.leroymerlin.fr/produits/colle-neoprene-multi-usages-sader-250-ml-82345671.html",
      "brand": "SADER",
      "price": 8.49,
      "title": "Colle néoprène multi-usages SADER, 250 ml",
      "rating": 4.3,
      "seller": {
        "name": "Bricomarket",
        "type": "3P"
      },
      "currency": "EUR",
      "discount": 3.5,
      "position": 9,
      "is_sponsored": false,
      "discount_rate": 29,
      "initial_price": 11.99,
      "price_excl_tax": 7.08,
      "total_offer_count": 4
    }
  ],
  "pagination": {
    "has_next": true,
    "total_pages": 41,
    "current_page": 1,
    "has_previous": false
  }
}
```

## Documentation

## Overview
The Leroy Merlin Search endpoint returns product listings and pagination for a keyword, SKU/EAN, or search URL.

Each result includes title, URL, SKU, brand, price, currency, seller, rating and discount. Seller type is `1P` (Leroy Merlin) or `3P` (marketplace).

Use `region` to target France or Romania. Default is France (`fr`, EUR). Romania is `ro` (RON). If `query` is a full Leroy Merlin URL, the country is detected automatically.

Optional `store_id` scopes prices and availability to a physical store.

## Quickstart
```
GET https://api.piloterr.com/v2/leroymerlin/search?query=colle+pvc
GET https://api.piloterr.com/v2/leroymerlin/search?query=perceuse&region=fr&page=1
GET https://api.piloterr.com/v2/leroymerlin/search?query=bormasina&region=ro
GET https://api.piloterr.com/v2/leroymerlin/search?query=https://www.leroymerlin.ro/search?q=drill
GET https://api.piloterr.com/v2/leroymerlin/search?query=colle+pvc&store_id=110
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword, SKU/EAN, or full Leroy Merlin search URL |
| `region` | string | no | Country (`fr`, `ro`) or alias (`romania`, …). Default `fr`. Auto-detected from URL `query` |
| `page` | integer | no | Page number (default `1`) |
| `store_id` | string | no | Store id for local prices/availability. Returns `400` if unknown for the region |
| `return_page_source` | boolean | no | When `true`, return raw HTML instead of JSON |

## Regions
| `region` | Site | Currency |
|---|---|---|
| `fr` (default) | www.leroymerlin.fr | EUR |
| `ro` | www.leroymerlin.ro | RON |

Aliases: `france` / `fr-fr` → `fr`; `romania` / `roumanie` / `ro-ro` → `ro`.

Priority: explicit `region` → country from URL `query` → default `fr`.

## Response fields
| Field | Type | Description |
|---|---|---|
| `region` | string | Resolved country (`fr` or `ro`) |
| `total` | integer | Products returned on this page |
| `results` | array | Product cards |
| `results[].sku` / `title` / `url` / `brand` | string | Product basics |
| `results[].price` / `price_excl_tax` / `currency` | number / string | Pricing |
| `results[].seller.name` / `seller.type` | string | Seller (`1P` or `3P`) |
| `pagination` | object | `current_page`, `total_pages`, `has_next`, `has_previous` |

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing `query`, or unknown `store_id` |
| `404` | No products found |
| `500` | Temporary failure after retries |

## Related endpoints
- [Leroy Merlin Product](https://www.piloterr.com/library/leroymerlin-product)
- [Leroy Merlin Stores Finder](https://www.piloterr.com/library/finder-leroymerlin-stores)
- [Leroy Merlin Products Finder](https://www.piloterr.com/library/finder-leroymerlin-products)

## Main use cases
- Product discovery and repricing in France and Romania
- Monitor prices and sellers for a keyword
- Resolve keywords or SKUs to product URLs