# Leroy Merlin Product Scraper (`sian.agency/leroy-merlin-product-scraper`) Actor Scrape Leroy Merlin (leroymerlin.fr) products — price in EUR, ratings, images, EAN & seller data. Keyword or category search, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/leroy-merlin-product-scraper.md - **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.75 / 1,000 overview products This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Leroy Merlin Product Scraper — Prices, Ratings & Product Data (France · EUR) 🛠️ [![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Home Depot Product Scraper](https://img.shields.io/badge/Store-Home%20Depot%20Product%20Scraper-F96302)](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) [![Google Shopping Price Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Scraper-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) #### 🎉 Pull Leroy Merlin prices, discounts, ratings, EAN/GTIN, and seller data — by keyword or category, no code ##### Built for retail analysts, e-commerce sellers, and brands who need fresh Leroy Merlin product data on demand --- ### 📋 Overview **Track every price, discount, and product detail on Leroy Merlin (leroymerlin.fr) — without writing a single line of code.** This scraper turns any Leroy Merlin search or category into a clean, structured spreadsheet of products, complete with prices in EUR, ratings, images, EAN/GTIN barcodes, and seller information (Leroy Merlin's own offers vs. third-party marketplace sellers). **Why professionals choose us:** - ✅ **Complete product data**: 20+ fields per product — price (incl. & excl. VAT), discount, rating, review count, brand, EAN/GTIN, seller, and more - ⚡ **Fast search-first mode**: pull 27 products per page in seconds; scale to thousands across multiple searches and categories - 🏬 **Marketplace insight**: see whether each offer is sold by Leroy Merlin (1P) or a third-party marketplace seller (3P), plus total competing offers - 💰 **Pay only for results**: charged per product you actually receive — no wasted spend, free tier to test - 💎 **Detail enrichment**: add the EAN/GTIN barcode, full description, hero image, availability, and review count with one switch - ✨ **France & EUR**: native French catalog, prices in euros, sort just like the leroymerlin.fr site --- ### ✨ Features - 🔎 **Keyword & Category Search**: scrape any Leroy Merlin search term or category page - 🏷️ **Full Pricing**: current price (VAT incl. & excl.), original/pre-discount price, and discount rate - ⭐ **Ratings & Reviews**: star rating and total review count for every product - 🏬 **Seller Data**: seller name, 1P (Leroy Merlin) vs 3P (marketplace) flag, and total offer count - 🔢 **Identifiers**: brand, SKU, and EAN/GTIN barcode for matching across catalogs - 🖼️ **Product Images**: hero image URL, ready for catalogs or feeds (Detail mode) - 📝 **Descriptions**: full product description (Detail mode) - 🧭 **Breadcrumbs & Categories**: the product's full category path for clean classification (Detail mode) - 📦 **Clean Export**: results delivered as structured JSON or CSV, ready for Excel or your database - 🚀 **No-Code Setup**: configure searches in a simple form — no scripts, no maintenance --- ### 🎬 Quick Start Enter one or more search keywords, pick a mode, and run. In under a minute you'll have a structured dataset of Leroy Merlin products you can download as JSON or CSV. No setup, no code. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~leroy-merlin-product-scraper/runs?token=YOUR_TOKEN \ -H 'Content-Type: application/json' \ -d '{"keywords": ["perceuse"], "scrapeMode": "overview"}' ```` *** ### 🚀 Getting Started (3 Simple Steps) #### Step 1: Add Your Searches Type one or more Leroy Merlin search keywords (e.g. `perceuse`, `robinet cuisine`) — one per line. #### Step 2: Choose Your Mode Pick **Overview** for fast search results, or **Detail** to also pull the EAN/GTIN, full description, image, availability, and review count. #### Step 3: Run & Download Click **Start**, then export your results as JSON, CSV, or Excel from the Apify dataset. **That's it! In just a few minutes, you'll have:** - A clean table of Leroy Merlin products with prices in EUR and discounts - Ratings, review counts, and seller data - EAN/GTIN barcodes and product images (Detail mode) *** ### 📥 Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | keywords | array | No | Leroy Merlin search terms, one per item (e.g. `perceuse`) | | categoryPaths | array | No | Advanced — Leroy Merlin category paths (e.g. `outillage/outillage-electroportatif/perceuse`) | | scrapeMode | string | No | `overview` (fast search) or `detail` (adds EAN, description, image, reviews) | | sort | string | No | `relevance`, `price_low`, or `price_high` | | maxResults | integer | No | Maximum products to return across all searches | **Example — fast search:** ```json { "keywords": ["perceuse", "robinet cuisine"], "scrapeMode": "overview", "sort": "price_low", "maxResults": 100 } ``` **Example — full detail with EAN & description:** ```json { "categoryPaths": ["outillage/outillage-electroportatif/perceuse"], "scrapeMode": "detail", "sort": "relevance", "maxResults": 50 } ``` *** ### 📤 Output Results are saved to the Apify dataset with **20+ fields per product**, including: | Field | Type | Description | |-------|------|-------------| | productTitle | string | Product name | | brand | string | Product brand | | sku | string | Leroy Merlin SKU | | gtin | string | EAN / GTIN barcode (Detail mode) | | price | number | Current price, VAT included (EUR) | | price\_excl\_tax | number | Price excluding VAT (EUR) | | original\_price | number | Pre-discount price | | discount\_rate | number | Discount percentage | | currency | string | Currency code (EUR) | | availability | string | Stock status (Detail mode) | | rating | number | Average star rating | | review\_count | number | Total number of reviews (Detail mode) | | seller\_name | string | Selling merchant | | seller\_type | string | 1P (Leroy Merlin) or 3P (marketplace) | | total\_offer\_count | number | Number of competing offers | | images | array | Product image URLs (Detail mode) | | breadcrumbs | array | Full category path (Detail mode) | | description | string | Product description (Detail mode) | **Example:** ```json { "item_id": "82550081", "productTitle": "Perceuse à percussion DEXTER Dp5, 900 W", "brand": "DEXTER", "sku": "82550081", "gtin": "3276007978681", "price": 40.9, "price_excl_tax": 34.08, "original_price": null, "discount_rate": null, "currency": "EUR", "rating": 4.4, "review_count": 25, "seller_name": "Leroy Merlin", "seller_type": "1P", "total_offer_count": 1, "images": ["https://media.adeo.com/media/5268135/media.png"], "breadcrumbs": ["Accueil", "Produits", "Outillage", "Perceuse"], "description": "Perceuse à percussion compacte et puissante..." } ``` *** ### 💼 Use Cases & Examples #### 1. Price Monitoring **Retailers and resellers tracking Leroy Merlin prices over time to stay competitive.** **Input:** Your product keywords and a daily schedule **Output:** Current price, pre-discount price, and discount rate for every match **Use:** Spot price drops, react to promotions, and keep your own pricing sharp. #### 2. Competitive Analysis **Brands and category managers benchmarking their products against the Leroy Merlin assortment.** **Input:** Category paths or keywords **Output:** Competitor prices, ratings, review counts, and seller mix **Use:** Understand where you win or lose on price and rating. #### 3. Catalog Building **E-commerce teams and marketplaces building a clean product catalog with images and EAN/GTIN.** **Input:** Keywords or category paths, in Detail mode **Output:** Titles, brands, SKUs, EAN/GTINs, images, and descriptions **Use:** Populate your storefront or PIM with structured, ready-to-use product data. #### 4. Marketplace Seller Analysis **Analysts studying the 1P vs 3P (marketplace) mix and offer competition on Leroy Merlin.** **Input:** Category paths across departments **Output:** Seller name, 1P/3P flag, and total offer count per product **Use:** Map marketplace penetration and competitive offer density by category. #### 5. MAP Compliance Monitoring **Manufacturers enforcing Minimum Advertised Price policies across Leroy Merlin listings.** **Input:** Your branded product keywords **Output:** Live listed prices and discounts per product and seller **Use:** Detect MAP violations quickly and protect your brand pricing. #### 6. Market Research & Trend Spotting **Analysts and researchers tracking best-sellers, ratings, and discount activity.** **Input:** Broad category keywords, sorted by price **Output:** Pricing distribution, rating trends, and discount activity **Use:** Surface emerging products and category trends before competitors do. *** ### 🔗 Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/leroy-merlin-product-scraper').call({ keywords: ['perceuse'], scrapeMode: 'overview' }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/leroy-merlin-product-scraper').call( run_input={'keywords': ['perceuse'], 'scrapeMode': 'overview'} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~leroy-merlin-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"keywords": ["perceuse"], "scrapeMode": "overview"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule (e.g. daily) or webhook 2. **HTTP Request**: Call the actor API with your keywords 3. **Process**: Handle the JSON results 4. **Action**: Save to a sheet, sync to a database, or send a price-drop alert *** ### 📊 Performance & Pricing #### FREE Tier (Try It Now) - **25 products** per run — full feature access, same data quality - No credit card required - Perfect for testing and small projects #### PAID Tier (Production Ready) - **Unlimited** products per run - Run multiple searches and large categories in one go - Pay-per-result: you're only charged for the products you actually receive 💰 **Best value on the market** — transparent pay-per-result pricing with no hidden subscription fees. 🔗 [View current pricing](https://apify.com/sian.agency/leroy-merlin-product-scraper?fpr=sian) *** ### ❓ Frequently Asked Questions **Q: How many products can I scrape?** A: FREE tier: 25 products per run. PAID tier: unlimited products across as many searches as you like. **Q: What's the difference between Overview and Detail mode?** A: Overview is the fast path — search results with price (EUR), brand, ratings, and seller data. Detail adds the EAN/GTIN barcode, full description, hero image, availability, and review count for every product. **Q: In which currency are prices returned?** A: Euros (EUR) — both VAT-inclusive (`price`) and VAT-exclusive (`price_excl_tax`) where available. **Q: Can I tell which products are sold by Leroy Merlin vs a marketplace seller?** A: Yes — every record carries `seller_name` and a `seller_type` flag (`1P` = Leroy Merlin's own offer, `3P` = third-party marketplace seller). **Q: What output formats are available?** A: JSON, CSV, and Excel — export directly from the Apify dataset. **Q: Can I scrape by category instead of keywords?** A: Yes — use the `categoryPaths` field with a Leroy Merlin category path (the most reliable option for large sweeps). **Q: Is this legal?** A: Yes — we only extract publicly available product data. See the legal section below. **Q: How fresh is the data?** A: Every run pulls live data directly from Leroy Merlin at the moment you run it. Schedule runs to keep prices up to date. *** ### 🐞 Troubleshooting **No results returned** - Check that your keywords match real Leroy Merlin products - Try a category path (the most reliable option) or a broader search term **Missing EAN, description, or image** - These only appear in **Detail** mode — switch `scrapeMode` to `detail` **Fewer results than expected on the free tier** - The FREE tier is capped at 25 products per run — upgrade to PAID for unlimited results *** ### ⚖️ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what is publicly shared. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### ⚖️ Trademark Disclaimer Leroy Merlin® is a trademark of Leroy Merlin / Groupe ADEO. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Leroy Merlin or Groupe ADEO. *** ### ⭐ Love This Tool? If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/leroy-merlin-product-scraper/reviews) — it helps other professionals discover it and helps us keep improving. *** ### 🤝 Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check the [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - 📧 #### More from SIÁN Agency - 🪚 [Home Depot Product Scraper](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) — full Home Depot product data, prices & store stock - 🛍️ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) — track offers and price history across the web *** **Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `keywords` (type: `array`): 🔍 **KEYWORD SEARCH:** Free-text Leroy Merlin searches — exactly what you'd type into the site's search bar. 📝 **EXAMPLES:** `perceuse` · `robinet cuisine` · `parquet chêne` · `peinture blanche` 💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset. 🖊️ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line). ✅ **IMPORTANT:** Provide either keywords OR category paths (at least one is needed to have something to scrape). ## `categoryPaths` (type: `array`): 🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Leroy Merlin category instead of a keyword search. 🔧 **HOW TO GET IT:** Open any Leroy Merlin category page and copy the path after `/produits/` from the URL (e.g. for `leroymerlin.fr/produits/outillage/outillage-electroportatif/perceuse/` paste `outillage/outillage-electroportatif/perceuse`). A full URL also works — it's normalized automatically. 💡 **TIP:** Leave this empty if you're only using keywords — it's an advanced alternative for category-level harvesting (and the most reliable path for large sweeps). 🖊️ **BULK EDIT:** Add one category path per line to sweep multiple categories in a single run. ## `scrapeMode` (type: `string`): ⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product. ⚡ **Overview (fast):** Search results only — price (EUR), brand, ratings, seller (own vs marketplace) and offer count. Fastest and cheapest path. 🔬 **Detail (enriched):** Everything in Overview PLUS the EAN/GTIN barcode, full product description, hero image, availability and review count scraped from each product page. 💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete product sheet for feeds or comparisons. ## `sort` (type: `string`): 🔃 **RESULT ORDERING:** Order results using Leroy Merlin's own native sort options — so you get the same ranking real shoppers see. 🏆 **Relevance** is the default ranking · 💲 **Price** sorts ascending or descending. ## `maxResults` (type: `integer`): 🔢 **RESULT CAP:** Maximum number of products to return across all keywords and categories combined. 🎁 **TIER-BASED LIMITS:** - **FREE users:** Up to 25 products per run - **PAID users:** Unlimited — scrape entire catalogs in a single run 💡 **TIP:** Starts at 25 (one page) so first runs are fast — raise it once the output looks right. ## Actor input object example ```json { "keywords": [ "perceuse" ], "categoryPaths": [], "scrapeMode": "overview", "sort": "relevance", "maxResults": 25 } ``` # Actor output Schema ## `leroyMerlinProducts` (type: `string`): Scraped Leroy Merlin products with prices, discounts, ratings, images, EAN/GTIN and seller data. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "perceuse" ], "maxResults": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/leroy-merlin-product-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["perceuse"], "maxResults": 25, } # Run the Actor and wait for it to finish run = client.actor("sian.agency/leroy-merlin-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "perceuse" ], "maxResults": 25 }' | apify call sian.agency/leroy-merlin-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/leroy-merlin-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Leroy Merlin Product Scraper", "description": "Scrape Leroy Merlin (leroymerlin.fr) products — price in EUR, ratings, images, EAN & seller data. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "U9I3b8s0NIMUZ39JS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~leroy-merlin-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-leroy-merlin-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~leroy-merlin-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-leroy-merlin-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~leroy-merlin-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-leroy-merlin-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "🔍 Search Keywords", "type": "array", "description": "🔍 **KEYWORD SEARCH:** Free-text Leroy Merlin searches — exactly what you'd type into the site's search bar.\n\n📝 **EXAMPLES:** `perceuse` · `robinet cuisine` · `parquet chêne` · `peinture blanche`\n\n💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset.\n\n🖊️ **BULK EDIT:** Click \"Bulk edit\" to paste many keywords at once (one per line).\n\n✅ **IMPORTANT:** Provide either keywords OR category paths (at least one is needed to have something to scrape).", "default": [ "perceuse" ], "items": { "type": "string" } }, "categoryPaths": { "title": "🧭 Category Paths (Advanced)", "type": "array", "description": "🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Leroy Merlin category instead of a keyword search.\n\n🔧 **HOW TO GET IT:** Open any Leroy Merlin category page and copy the path after `/produits/` from the URL (e.g. for `leroymerlin.fr/produits/outillage/outillage-electroportatif/perceuse/` paste `outillage/outillage-electroportatif/perceuse`). A full URL also works — it's normalized automatically.\n\n💡 **TIP:** Leave this empty if you're only using keywords — it's an advanced alternative for category-level harvesting (and the most reliable path for large sweeps).\n\n🖊️ **BULK EDIT:** Add one category path per line to sweep multiple categories in a single run.", "default": [], "items": { "type": "string" } }, "scrapeMode": { "title": "⚙️ Scrape Mode", "enum": [ "overview", "detail" ], "type": "string", "description": "⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\n⚡ **Overview (fast):** Search results only — price (EUR), brand, ratings, seller (own vs marketplace) and offer count. Fastest and cheapest path.\n\n🔬 **Detail (enriched):** Everything in Overview PLUS the EAN/GTIN barcode, full product description, hero image, availability and review count scraped from each product page.\n\n💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete product sheet for feeds or comparisons.", "default": "overview" }, "sort": { "title": "🔃 Sort Order", "enum": [ "relevance", "price_low", "price_high" ], "type": "string", "description": "🔃 **RESULT ORDERING:** Order results using Leroy Merlin's own native sort options — so you get the same ranking real shoppers see.\n\n🏆 **Relevance** is the default ranking · 💲 **Price** sorts ascending or descending.", "default": "relevance" }, "maxResults": { "title": "🔢 Max Results", "minimum": 1, "type": "integer", "description": "🔢 **RESULT CAP:** Maximum number of products to return across all keywords and categories combined.\n\n🎁 **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited — scrape entire catalogs in a single run\n\n💡 **TIP:** Starts at 25 (one page) so first runs are fast — raise it once the output looks right.", "default": 25 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```