# Leroy Merlin Product

## Overview

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

## Description

Live Leroy Merlin product detail for France and Romania from a URL or identifier: offers, currency, images, features and store context.

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

## Example Response

### Product by URL (Zellige tile, store=110)

```json
{
  "sku": "82311569",
  "url": "https://www.leroymerlin.fr/produits/carrelage-mur-interieur-effet-zellige-blanc-casse-zellie-l-10-x-l-10-cm-x-ep-10-82311569.html",
  "store": {
    "id": "110",
    "slug": "balma-toulouse"
  },
  "title": "Carrelage mur intérieur effet zellige blanc cassé Zellie l.10 x L.10 cm x Ep.10",
  "images": [
    "https://media.adeo.com/media/1102654/media.jpg",
    "https://media.adeo.com/media/1034533/media.jpg",
    "https://media.adeo.com/media/1742409/media.jpg",
    "https://media.adeo.com/media/3210749/media.jpg"
  ],
  "rating": 4.37,
  "region": "fr",
  "features": {
    "Forme": "Carré",
    "Aspect": "Brillant",
    "Couleur": "Blanc cassé",
    "Largeur (en cm)": "10",
    "Longueur (en cm)": "10",
    "Epaisseur (en mm)": "10",
    "Pays de fabrication": "Italie",
    "Destination du carrelage": "Mur intérieur",
    "Contenance de la boîte (en m²)": "0.54",
    "Nombre de carreaux dans la boîte": "54"
  },
  "best_offer": {
    "price": 21.54,
    "seller": {
      "id": "12136181",
      "name": "Leroy Merlin",
      "type": "1P"
    },
    "currency": "EUR",
    "available": true,
    "deliveries": [
      {
        "time": "3 OPENING_DAY",
        "type": "relayDelivery",
        "price": 1.9,
        "stock": 2823,
        "stock_status": "ONSITE"
      },
      {
        "time": "5 OPENING_DAY",
        "type": "homeDelivery",
        "price": 4.9,
        "stock": 2823,
        "stock_status": "ONSITE"
      }
    ],
    "offer_type": "NEW",
    "price_excl_tax": 17.95
  },
  "breadcrumb": [
    {
      "url": "https://www.leroymerlin.fr/",
      "name": "Accueil",
      "position": 1
    },
    {
      "url": "https://www.leroymerlin.fr/produits/",
      "name": "Produits",
      "position": 2
    },
    {
      "url": "https://www.leroymerlin.fr/produits/revetement-sol-et-mur/",
      "name": "Revêtement sol, mur et peinture",
      "position": 3
    },
    {
      "url": "https://www.leroymerlin.fr/produits/revetement-sol-et-mur/carrelage/",
      "name": "Carrelage sol et mur",
      "position": 4
    },
    {
      "url": "https://www.leroymerlin.fr/produits/revetement-sol-et-mur/carrelage/carrelage-mural/",
      "name": "Carrelage mural et faïence",
      "position": 5
    },
    {
      "url": "https://www.leroymerlin.fr/produits/revetement-sol-et-mur/carrelage/carrelage-mural/zellige/",
      "name": "Zellige",
      "position": 6
    },
    {
      "url": "https://www.leroymerlin.fr/produits/carrelage-mur-interieur-effet-zellige-blanc-casse-zellie-l-10-x-l-10-cm-x-ep-10-82311569.html",
      "name": "Carrelage mur intérieur effet zellige blanc cassé Zellie l.10 x L.10 cm x Ep.10",
      "position": 7
    }
  ],
  "description": "Pour avoir un résultat aussi authentique que les zelliges du Maroc, nous vous conseillons de les poser sans croisillon. C'est l'effet irrégulier du produit, tant dans l'aspect des carreaux que dans la pose, qui apporte le charme esthétique de cette série. Ce produit vous permet de bénéficier de la simplicité du carrelage : il est facile d'entretien car non poreux.",
  "marketing_tag": "RESPONSIBLE_SECONDARY",
  "reviews_count": 282,
  "total_offer_count": 1,
  "sellers_composition": "1P_only"
}
```

## Documentation

## Overview
The Leroy Merlin Product endpoint returns a full product page: title, brand, description, images, rating, best offer, other marketplace offers, features and breadcrumb.

Pass a product URL or an identifier (SKU / EAN / text). If `query` is not a URL, Piloterr searches then follows the redirect to the product page when the match is clear enough.

Use `region` for France or Romania. Default is France (`fr`, EUR). Romania is `ro` (RON). A full URL auto-detects the country.

Optional `store_id` scopes the offer to a store. The `store` block appears only when `store_id` is set.

## Quickstart
```
GET https://api.piloterr.com/v2/leroymerlin/product?query=https://www.leroymerlin.fr/produits/bobine-soudure-63378273.html&store_id=110
GET https://api.piloterr.com/v2/leroymerlin/product?query=https://www.leroymerlin.ro/produits/...&region=ro
GET https://api.piloterr.com/v2/leroymerlin/product?query=63378273&region=fr
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product URL, or identifier (SKU / EAN / text) |
| `region` | string | no | Country (`fr`, `ro`) or alias. Default `fr`. Auto-detected from URL `query` |
| `store_id` | string | no | Store id for local offer context. Returns `400` if unknown |
| `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`.

## Response fields
| Field | Type | Description |
|---|---|---|
| `region` | string | Resolved country |
| `sku` / `title` / `url` / `brand` | string | Product identity |
| `description` / `images` | string / array | Content |
| `rating` / `reviews_count` | number / integer | Reviews |
| `best_offer` | object | Main offer (price, currency, seller, stock, deliveries) |
| `other_offers` | array | Other sellers |
| `features` / `breadcrumb` | array/object | Specs and categories |
| `store` | object | Present only when `store_id` was passed |

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

## Related endpoints
- [Leroy Merlin Search](https://www.piloterr.com/library/leroymerlin-search)
- [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
- Monitor price and stock per product and store in FR/RO
- Compare `1P` and marketplace offers
- Enrich catalogs with description, images and features