leroymerlin.fr APIwww.leroymerlin.fr ↗
Access LeroyMerlin.fr product catalog via API. Search products, get pricing and seller info, browse 2.4M+ products across 99 sitemaps, and list category hierarchies.
curl -X GET 'https://api.parse.bot/scraper/b6e2c583-ae27-47dd-a002-ee51c04500cf/search_products?limit=5&query=peinture' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on LeroyMerlin.fr by keyword. Returns product listings with prices and seller info.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| limit | integer | Maximum number of products to return |
| queryrequired | string | Search keyword (e.g., 'peinture', 'perceuse') |
{
"type": "object",
"fields": {
"page": "integer",
"query": "string",
"products": "array",
"product_count": "integer",
"total_results": "integer"
},
"sample": {
"page": 1,
"query": "peinture",
"products": [
{
"url": "https://www.leroymerlin.fr/produits/peinture-blanche-82501694.html",
"name": "Peinture blanche",
"brand": "Luxens",
"price": 29.9,
"seller": "Leroy Merlin",
"currency": "EUR",
"product_id": "82501694",
"is_marketplace": false
}
],
"product_count": 1,
"total_results": 1500
}
}About the leroymerlin.fr API
The Leroy Merlin France API provides 4 endpoints to search and browse the LeroyMerlin.fr product catalog, covering over 2.4 million products across 99 sitemap partitions. The search_products endpoint accepts a French-language keyword and returns paginated listings with prices and seller attribution. Individual product records expose brand, price, currency, seller identity, and a marketplace flag distinguishing Leroy Merlin direct listings from third-party online partners.
Product Search and Detail
The search_products endpoint accepts a query string (French terms such as peinture or perceuse) plus optional page and limit parameters, returning an array of product listings alongside total_results and product_count for pagination control. The get_product_details endpoint resolves either a numeric product_id or a full product_url to a single product record containing name, brand, price, currency, seller, description, and the is_marketplace boolean that distinguishes inventory sold directly by Leroy Merlin from listings fulfilled by online partners.
Catalog Enumeration via Sitemaps
The list_products_from_sitemap endpoint gives direct access to the underlying catalog breadth. Each call targets one of the 99 sitemap files using the sitemap_number parameter (1–99); each file contains approximately 25,000 products. Responses include a products array of objects with product_id, name, and url, plus total_urls_in_sitemap so you can gauge completeness. This is the right endpoint for bulk catalog mirroring or building a local product index.
Category Hierarchy
The list_categories endpoint returns category records sourced from the site's category sitemap. Each category object carries a url, path, name, and depth integer representing its level in the hierarchy, alongside a total_categories_in_sitemap count. Use depth to distinguish top-level departments from subcategories and build tree structures for navigation or taxonomy mapping.
- Monitor price changes on specific Leroy Merlin products by polling
get_product_detailswith a product ID. - Build a French home improvement product index by iterating
list_products_from_sitemapacross all 99 sitemap files. - Identify which products are sold by third-party partners versus Leroy Merlin directly using the
is_marketplacefield. - Seed a category navigation tree for a home improvement vertical using the
depthandpathfields fromlist_categories. - Run competitive keyword research against the LeroyMerlin.fr catalog using
search_productswith category-specific French terms. - Enrich an internal product database with brand, description, and seller fields from
get_product_details. - Map the full category taxonomy to a custom taxonomy by crawling
list_categoriesand comparingpathvalues.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Leroy Merlin France offer an official developer API?+
How does `get_product_details` distinguish Leroy Merlin products from marketplace seller products?+
is_marketplace boolean field. When true, the product is listed by an online partner rather than sold directly by Leroy Merlin. The seller string field names the specific seller in either case.Are product reviews or ratings available from the API?+
Is stock availability or inventory status returned by any endpoint?+
get_product_details and search_products endpoints return pricing and seller information but do not expose in-store or online stock levels. You can fork this API on Parse and revise it to add stock availability if needed.How complete is the sitemap-based catalog coverage, and can I access it in bulk?+
list_products_from_sitemap endpoint covers 99 sitemap files with approximately 25,000 product entries each, totaling roughly 2.4 million products. The total_urls_in_sitemap field in each response tells you the exact count for a given sitemap file. Use the sitemap_number parameter (1–99) to iterate through the full catalog.