leroymerlin.pt APIleroymerlin.pt ↗
Access Leroy Merlin Portugal product listings, prices, specs, categories, and workshop schedules via a structured API. 5 endpoints covering catalog and events.
curl -X GET 'https://api.parse.bot/scraper/2fdc2f1f-164a-408a-9e84-325d1face053/search_products?query=tinta' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on leroymerlin.pt. Returns product listings with name, price, rating, URL, image, and SKU. Results are from the first page of search results.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'martelo', 'tinta') |
{
"type": "object",
"fields": {
"count": "integer total number of products returned",
"products": "array of product objects with name, price, rating, url, image, and sku fields"
},
"sample": {
"data": {
"count": 56,
"products": [
{
"sku": "95456434",
"url": "https://www.leroymerlin.pt/produtos/martelo-rompedor-pneumatico-succebuy-rompedor-de-concreto-1400w-martelo-eletrico-2-cinzeis-succebuy-95456434.html",
"name": "Martelo rompedor pneumático SucceBuy Rompedor de concreto 1400W Martelo elétrico 2 cinzéis SucceBuy",
"image": "https://media.adeo.com/mkp/d2878eb3624bbfa99281baa3093f0dea/media.jpg?width=300",
"price": "67,56 €",
"rating": "(8)"
}
]
},
"status": "success"
}
}About the leroymerlin.pt API
The Leroy Merlin Portugal API covers 5 endpoints that expose product search, product details, category navigation, and workshop scheduling from leroymerlin.pt. The search_products endpoint returns up to a page of results with fields including name, price, rating, image URL, and SKU for each matched item. Workshop endpoints surface store-by-store session schedules, making it straightforward to track DIY training events across Portuguese locations.
Product Search and Details
The search_products endpoint accepts a query string — such as 'martelo' or 'tinta' — and returns a count alongside a products array. Each product object includes name, price, rating, url, image, and sku. Results reflect the first page of search results for the given keyword. For deeper information on any item, pass its page URL to get_product_details, which returns name, price, a description string, a reference identifier, an images array, and a specifications object containing structured attribute data.
Category Navigation
The get_product_categories endpoint requires no inputs and returns a categories array. Each entry includes a name and a url, covering top-level departments and featured subcategories as they appear in the site navigation. This is useful for building category browsers or mapping the product taxonomy before running targeted searches.
Workshops and Store Schedules
The get_workshops endpoint returns a workshops array with title, url, and date for each upcoming session listed on the Leroy Merlin Portugal workshops section. To retrieve full event details, pass any workshop url to get_workshop_details, which returns title, description, and an agenda array. The agenda includes the store-by-store schedule, indicating which physical locations host each session — useful for location-aware event applications.
- Build a price-tracking tool by periodically calling
search_productswith specific keywords and storing the returnedpriceandskufields. - Populate a product comparison page using
get_product_detailsto retrievespecificationsanddescriptionfor multiple product URLs. - Generate a sitemap or category browser from the
nameandurlfields returned byget_product_categories. - Send alerts to users about upcoming DIY workshops in their area using
dateand store-location data fromget_workshop_details. - Index product
ratingvalues fromsearch_productsto surface top-rated items within a given category. - Aggregate workshop schedules by store location using the
agendaarray fromget_workshop_detailsto show which sessions are nearest to a user. - Sync product
referenceandskufields fromget_product_detailsinto an internal inventory or procurement database.
| 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 Portugal offer an official developer API?+
Does `search_products` return results beyond the first page?+
What does the `agenda` field in `get_workshop_details` contain?+
agenda field is an array that breaks down the workshop schedule store by store, showing which Leroy Merlin Portugal locations are hosting each session. This is distinct from the top-level date on the listing returned by get_workshops, which gives only a summary date.Does the API expose product stock availability or inventory levels?+
search_products and get_product_details endpoints return pricing, specifications, and descriptions but do not include stock status or per-store inventory data. You can fork the API on Parse and revise it to add an endpoint targeting stock availability data if that information becomes accessible.Are customer reviews or review counts accessible through this API?+
search_products endpoint returns a rating field per product, but individual review text and review counts are not exposed. The get_product_details endpoint also does not include a reviews array. You can fork this API on Parse and revise it to add a dedicated reviews endpoint.