Leroy Merlin Spain Product Scraper

Pull product data from Leroy Merlin Spain (leroymerlin.es), a leading DIY and home-improvement retailer. Search by keyword, a real leroymerlin.es catalog category, or paste product and listing links directly. Every record includes the current price, the strike-through original price with discount when a product is genuinely on offer, and -- with detail on -- every competing marketplace offer for that product.

Why This Scraper?

• Was-price and discount, structured, not scraped from a badge. When a product is marked down, both the current and original price are captured plus the discount amount and percentage. Full-price products carry null, never a fabricated discount.
• Marketplace transparency. Leroy Merlin sells both directly and through third-party sellers on the same product page. Every record identifies the seller (Leroy Merlin vs marketplace) and, with detail on, lists every competing offer for that product -- price, stock, and delivery time per seller.
• Reviews straight from the product page. Overall rating, review count, and individual customer reviews (author, date, rating, body) -- not a third-party review vendor.
• Two ways in. Keyword or category search with real site filters (price range, rating, promotion, seller, sort), or paste any product/listing link and continue pagination automatically.
• Optional export to your apps. Send results into Notion, Linear, Airtable, or any Apify MCP connector alongside the dataset.

Data You Get

Field	Example value
productId / sku	123456
name	Sample Cordless Drill 18V
brand	SAMPLE BRAND
category / categoryPath	Cordless drills, ["Tools", "Power tools", "Drilling & screwing", "Drills", "Cordless drills"]
url	https://www.leroymerlin.es/productos/sample-cordless-drill-18v-123456.html
price / priceExclTax / currency	99.99, 82.64, EUR
originalPrice / discountAmount / discountPercent	129.99, 30.00, 23.1
isOnSpecial	true
rating	4.7
sellerId / sellerName / sellerType	002, Sample Retailer, 1P
totalOfferCount / sellersComposition	12, 1P_3P
sponsored	false
ean	4000000000000
description	full product description text
image / numberOfImages	https://media.example.com/sample.jpg, 5
stock / stockStatus / deliveryTime	19, ONSITE, 1 OPENING_DAY
otherOffers[]	[{"sellerName": "Sample Marketplace Seller", "sellerType": "3P", "price": 105.40, "stock": 3, "deliveryTime": "3 OPENING_DAY"}]
reviews.averageRating / reviews.totalReviewCount	4.7, 275
reviews.items[]	[{"rating": 5, "body": "Sample review text.", "author": "Sample Customer", "date": "2026-07-15"}]

Sample shape: values above are illustrative placeholders, not from a live product.

How to Use

1. Keyword search, first page, with detail and reviews (default):

{
  "mode": "search",
  "searchTerm": "taladro",
  "maxItems": 20
}

2. Category browse, only products on promotion, sorted by price:

{
  "mode": "search",
  "category": "herramientas/herramientas-electricas-portatiles/herramientas-electricas-para-taladrar-atornillar/taladros/taladros-de-bateria",
  "onPromotionOnly": true,
  "sortBy": "price_asc",
  "maxItems": 50,
  "maxPages": 5
}

3. Only Leroy Merlin's own offers, minimum 4-star rating:

{
  "mode": "search",
  "searchTerm": "grifo cocina",
  "sellerFilter": "leroymerlin",
  "minRating": 4,
  "maxItems": 30
}

4. Full detail and reviews for a pasted product link:

{
  "mode": "url",
  "urls": ["https://www.leroymerlin.es/productos/sample-cordless-drill-18v-123456.html"],
  "fetchDetails": true,
  "fetchReviews": true
}

Input Parameters

Parameter	Type	Description
mode	string	search or url.
searchTerm	string	Keyword (search mode only).
category	string	A real leroymerlin.es catalog category path (search mode only). Ignored when searchTerm is set.
sortBy	string	relevance, price_asc, or price_desc (search mode only).
minPrice / maxPrice	number	EUR price band to keep.
minRating	number	Minimum average rating (0-5) to keep.
onPromotionOnly	boolean	Keep only products currently on promotion.
sellerFilter	string	any, leroymerlin, or marketplace.
urls	array	Product or listing (search/category) URLs to scrape (url mode only).
fetchDetails	boolean	Fetch EAN, description, image, breadcrumb category path, stock/delivery, and every competing marketplace offer.
fetchReviews	boolean	Fetch the product's own reviews. Shares the same page fetch as fetchDetails.
maxReviewsPerProduct	integer	Cap on reviews per product; the product page itself only ever surfaces its most recent reviews.
maxPages	integer	Cap on result pages per search/category/URL entry; empty = unlimited.
maxItems	integer	Cap on total products returned; 0 = unlimited.
proxy	object	Apify proxy configuration. A residential connection in Spain is required (see below).
mcpConnectors	array	Optional MCP connectors to export results into (Notion, Linear, Airtable, Apify).
notionParentPageUrl	string	Notion connector only: page under which item pages are created.
maxNotifyListings	integer	Cap on items exported to each connector per run. Does not affect the dataset.

Output Example

{
  "productId": "123456",
  "sku": "123456",
  "name": "Sample Cordless Drill 18V",
  "brand": "SAMPLE BRAND",
  "url": "https://www.leroymerlin.es/productos/sample-cordless-drill-18v-123456.html",
  "price": 99.99,
  "priceExclTax": 82.64,
  "currency": "EUR",
  "originalPrice": 129.99,
  "discountAmount": 30.0,
  "discountPercent": 23.1,
  "isOnSpecial": true,
  "rating": 4.7,
  "sellerId": "002",
  "sellerName": "Sample Retailer",
  "sellerType": "1P",
  "totalOfferCount": 12,
  "sellersComposition": "1P_3P",
  "sponsored": false,
  "offerType": "NEW",
  "ean": "4000000000000",
  "description": "Sample product description as shown on the site.",
  "image": "https://media.example.com/sample.jpg",
  "numberOfImages": 5,
  "categoryPath": ["Tools", "Power tools", "Drilling & screwing", "Drills", "Cordless drills"],
  "category": "Cordless drills",
  "stock": 19,
  "stockStatus": "ONSITE",
  "deliveryTime": "1 OPENING_DAY",
  "otherOffers": [
    { "sellerName": "Sample Marketplace Seller", "sellerType": "3P", "price": 105.40, "stock": 3, "deliveryTime": "3 OPENING_DAY" }
  ],
  "numberOfReviews": 275,
  "reviews": {
    "averageRating": 4.7,
    "totalReviewCount": 275,
    "items": [
      { "rating": 5, "body": "Sample review text.", "author": "Sample Customer", "date": "2026-07-15" }
    ]
  },
  "searchMode": "search"
}

Sample shape: values above are illustrative placeholders, not from a live product.

A note on reviews and marketplace offers

Reviews come directly from the product page itself, not a third-party review vendor -- the page only ever surfaces its most recent reviews, while the overall rating and review count reflect the full history. otherOffers lists every competing offer visible on the product page at fetch time (price, stock, delivery); products sold exclusively by Leroy Merlin with no marketplace competition simply omit the field rather than returning an empty placeholder.

Send results into your apps (MCP connectors)

Optionally pipe results into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it in the mcpConnectors field. Each connector receives a condensed, human-readable summary per product (name plus key fields), while the complete record always stays in the Apify dataset. For Notion, set notionParentPageUrl to the page the item pages should be created under, and use maxNotifyListings to cap how many items are exported per connector per run. Supported connectors: Notion, Linear, Airtable, and Apify. Leave the field empty to skip; it never changes the dataset output.

A note on plans

leroymerlin.es answers only on a Spanish residential connection -- a datacenter connection is refused and returns no results. Use Apify Proxy with residential access (country Spain), which this actor selects by default.