Piloterr

Leroy Merlin Product

GET
/v2/leroymerlin/product

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

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Full Leroy Merlin product URL, or an identifier (SKU / EAN / text).

Examples:

https://www.leroymerlin.fr/produits/bobine-soudure-63378273.html
https://www.leroymerlin.ro/produits/scara-aluminiu-12345678.html
63378273

When query is not a URL, Piloterr searches and follows the redirect to the product page when the match is clear enough. When query is a full URL, region is detected from the domain.

region?string

Leroy Merlin country when query is a keyword or identifier (default: fr). Ignored when query is a full Leroy Merlin URL (country is detected from the domain).

Supported regions:

Examples:

fr
ro
romania
store_id?string

Optional store id for local offer context (prices, stock, deliveries). Must exist for the active region. Returns 400 when unknown.

The response store block is present only when this parameter is set.

Example: 110

return_page_source?boolean

When set to true, returns the raw HTML of the product page instead of the parsed JSON payload. Useful for debugging or custom parsing. The response shape is {"return": "<html>..."}. Defaults to false.

Example: true

Defaultfalse
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
sku?string
url?string
store?
title?string
images?array<string>
rating?number
region?string
features?
best_offer?
breadcrumb?array<>
description?string
marketing_tag?string
reviews_count?integer
total_offer_count?integer
sellers_composition?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/leroymerlin/product?query=string'
Example Response
{  "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"}