# Leroy Merlin France — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse Leroy Merlin France's complete product catalog to find items by category, view pricing, product details, and compare offerings from Leroy Merlin and their online partners. Access real-time product information including names, IDs, URLs, and seller details to help you discover and evaluate home improvement and DIY products.

**Category:** E-commerce | **Website:** [www.leroymerlin.fr/](https://www.leroymerlin.fr/) | **Docs:** [parse.bot/marketplace/5bbd6f67-2778-4942-9382-059e573f661d/leroymerlin-fr-api](https://parse.bot/marketplace/5bbd6f67-2778-4942-9382-059e573f661d/leroymerlin-fr-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-leroymerlin-fr-api-5bbd6f67/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Get detailed product information including price and seller (Leroy Merlin or Online Partner).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | Product ID (numeric, e.g., '82862131'). Will search sitemaps for the URL. |
| `product_url` | string | No | Full product URL from LeroyMerlin.fr |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leroymerlin-fr-api-5bbd6f67/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","product_url":"<string>"}'
```

### list_categories

List product categories from LeroyMerlin.fr category sitemap. Returns category names, URLs, paths, and hierarchy depth. Categories are extracted from the category XML sitemap. Depth indicates nesting level (1 = top-level category, higher = subcategory).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of categories to return |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leroymerlin-fr-api-5bbd6f67/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### list_products_from_sitemap

List products from LeroyMerlin.fr product sitemaps. Returns product URLs, IDs, and names extracted from XML sitemaps. There are 99 product sitemaps with approximately 25,000 products each. Product names are derived from URL slugs (title-cased, hyphens replaced with spaces).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of products to return |
| `sitemap_number` | integer | No | Sitemap file number (1-99) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leroymerlin-fr-api-5bbd6f67/list_products_from_sitemap \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","sitemap_number":"<integer>"}'
```

### search_products

Search for products on LeroyMerlin.fr by keyword. Returns product listings with prices and seller info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of products to return |
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword (e.g., 'peinture', 'perceuse') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leroymerlin-fr-api-5bbd6f67/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```