# Leroy Merlin Products Finder

## Overview

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

## Description

Find Leroy Merlin product URLs by product name, ID, or any combination of filters to use in product detail and rendering API calls.

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

## Example Response

### Search by query 'festool'

```json
[
  {
    "id": "83733175",
    "url": "https://www.leroymerlin.fr/produits/sacs-filtre-double-paroi-festool-fis-sr-202-5-pieces-487482-83733175.html",
    "title": "Sacs filtre double paroi FESTOOL FIS-SR 202 - 5 pièces - 487482",
    "domain": "fr"
  },
  {
    "id": "83733177",
    "url": "https://www.leroymerlin.fr/produits/sac-filtre-longlife-longlife-fis-ct-sys-festool-500642-83733177.html",
    "title": "Sac filtre Longlife Longlife-FIS-CT SYS - FESTOOL 500642",
    "domain": "fr"
  },
  {
    "id": "83733153",
    "url": "https://www.leroymerlin.fr/produits/sac-elimination-des-dechets-festool-ens-ct-48-ac-5-pieces-497540-83733153.html",
    "title": "Sac d'élimination des déchets FESTOOL ENS-CT 48 AC - 5 pièces - 497540",
    "domain": "fr"
  },
  {
    "id": "83733154",
    "url": "https://www.leroymerlin.fr/produits/5-sacs-elimination-des-dechets-ens-ct-26-ac-5-83733154.html",
    "title": "5 Sacs d'élimination des déchets ENS-CT 26 AC/5",
    "domain": "fr"
  },
  {
    "id": "83733155",
    "url": "https://www.leroymerlin.fr/produits/sac-filtre-selfclean-sc-fis-ct-sys-5-festool-500438-83733155.html",
    "title": "Sac filtre SELFCLEAN SC FIS-CT SYS/5 - FESTOOL 500438",
    "domain": "fr"
  },
  {
    "id": "83733156",
    "url": "https://www.leroymerlin.fr/produits/sac-filtre-festool-fis-ct-55-5-pieces-452973-83733156.html",
    "title": "Sac filtre FESTOOL FIS-CT 55 - 5 pièces - 452973",
    "domain": "fr"
  },
  {
    "id": "83733157",
    "url": "https://www.leroymerlin.fr/produits/sac-filtre-festool-fis-ct-44-sp-vlies-5-pieces-456874-83733157.html",
    "title": "Sac filtre FESTOOL FIS-CT 44 SP VLIES - 5 pièces - 456874",
    "domain": "fr"
  },
  {
    "id": "83733158",
    "url": "https://www.leroymerlin.fr/produits/sac-filtre-selfclean-sc-fis-ct-48-festool-5-pieces-497539-83733158.html",
    "title": "Sac filtre Selfclean SC FIS-CT 48 FESTOOL - 5 pièces - 497539",
    "domain": "fr"
  },
  {
    "id": "83733165",
    "url": "https://www.leroymerlin.fr/produits/sacs-filtre-double-paroi-festool-fis-sr-150-5-pieces-488460-83733165.html",
    "title": "Sacs filtre double paroi FESTOOL FIS-SR 150 - 5 pièces - 488460",
    "domain": "fr"
  },
  {
    "id": "83733170",
    "url": "https://www.leroymerlin.fr/produits/sac-filtre-festool-longlife-fis-ct-22-456737-83733170.html",
    "title": "Sac filtre FESTOOL Longlife - FIS-CT 22 - 456737",
    "domain": "fr"
  }
]
```

### Lookup multiple IDs

```json
[
  {
    "id": "84827484",
    "url": "https://www.leroymerlin.fr/produits/a-tec-gris-310ml-par-12-84827484.html",
    "title": "A-TEC gris 310ml (Par 12)",
    "domain": "fr"
  },
  {
    "id": "84827521",
    "url": "https://www.leroymerlin.fr/produits/a-tec-blanc-310ml-par-12-84827521.html",
    "title": "A-TEC blanc 310ml (Par 12)",
    "domain": "fr"
  }
]
```

### Search with count=true

```json
{
  "hits": [
    {
      "id": "83733175",
      "url": "https://www.leroymerlin.fr/produits/sacs-filtre-double-paroi-festool-fis-sr-202-5-pieces-487482-83733175.html",
      "title": "Sacs filtre double paroi FESTOOL FIS-SR 202 - 5 pièces - 487482",
      "domain": "fr"
    },
    {
      "id": "83733177",
      "url": "https://www.leroymerlin.fr/produits/sac-filtre-longlife-longlife-fis-ct-sys-festool-500642-83733177.html",
      "title": "Sac filtre Longlife Longlife-FIS-CT SYS - FESTOOL 500642",
      "domain": "fr"
    }
  ],
  "count": 1247
}
```

## Documentation

## Overview
The Leroy Merlin Products Finder endpoint allows you to discover Leroy Merlin product URLs by searching with a product name, ID, or any combination of filters. It is primarily designed as a pre-step before calling the Website Rendering API on Leroy Merlin product pages, enabling you to resolve identifiers into actionable product URLs.

## Quickstart
```
GET https://api.piloterr.com/v2/finder/leroymerlin-products?search=perceuse
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `search` | string | conditional | Free-text search across product titles and IDs. Required if no filter is provided. |
| `query` | string | conditional | Legacy alias of `search`. |
| `id` | string | no | One or several internal product IDs (comma-separated). |
| `domain` | string | no | One or several website domains (comma-separated). |
| `filter` | string | no | Raw filter expression for advanced filtering. |
| `limit` | integer | no | Max results, default `10`, capped at `100`. |
| `offset` | integer | no | Pagination offset, default `0`. |
| `sort` | string | no | Sort attributes (e.g. `title:asc`, comma-separated). |
| `fields` | string | no | Comma-separated list of fields to return. |
| `count` | boolean | no | When `true`, wraps the response as `{ count, hits }`. Default `false`. |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Internal product identifier |
| `url` | string | Direct Leroy Merlin product URL |
| `title` | string | Full product title |
| `domain` | string | Website domain (e.g. `fr`) |
| `count` | integer | Total estimated number of matches (only when `count=true`) |
| `hits` | array | Array of product objects (only when `count=true`) |

## Notes
- At least one of `search` (or `query`) or a filter must be provided.
- Returns up to `limit` results ordered by relevance (or by `sort`).
- When `count=true`, an empty result set returns `{ count: 0, hits: [] }` with a 200 status. Without `count`, an empty result set returns a 404.
- Use returned URLs with the Website Rendering API to extract full product data.
- Accepts both free-text product names (in French) and numeric product IDs.

## Main use cases
- Find Leroy Merlin product URLs by keyword or ID before rendering product detail pages.
- Resolve a batch of internal product IDs to URLs in a single call.
- Build a DIY and home improvement product catalog from Leroy Merlin.
- Estimate the size of a result set with `count=true` before paginating through it.
- Automate price monitoring pipelines for hardware and home improvement products.
- Cross-reference product references across French home improvement retailers.