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
x-api-key<token>

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

In: header

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

Default"false"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/leroymerlin/product?query=string"
{  "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"}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}