{ "openapi": "3.0.1", "info": { "title": "Leroy Merlin Scraper — French DIY & Home Improvement", "description": "Scrape products, prices, specifications, ratings, and availability from leroymerlin.fr. France's largest home improvement retailer with 140+ stores. Supports search queries and category browsing.", "version": "0.1", "x-build-id": "bAayvUwAEB1Fd0jYu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~leroymerlin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-leroymerlin-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/studio-amba~leroymerlin-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-leroymerlin-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/studio-amba~leroymerlin-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-leroymerlin-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "French product keyword, e.g. \"peinture\", \"perceuse filaire\", \"carrelage\". The actor scrapes the site's own search results for it (recommended mode: the search route is the one that works for automated access). Leave Category URL and Start URLs EMPTY to use search; they take priority over this field." }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "A Leroy Merlin category page URL, e.g. https://www.leroymerlin.fr/produits/outillage/outillage-electroportatif/perceuse/perceuse-filaire/. DataDome currently blocks category pages for automated access, so the actor serves the site's search results for the category keyword (the last path segment, e.g. \"perceuse filaire\"). When the keyword is itself a category name (e.g. \"outillage\") the site redirects that search to the blocked page, and the actor serves the site's related searches for it instead (e.g. \"outillage makita\", \"outillage electricien\"). The log and the run's status message say which route served the run. The results are the site's search ranking, not the category tree. If set, it takes priority over Search Query." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Leroy Merlin URLs to scrape (category pages, search result pages, or individual product pages ending in -.html). Takes priority over Category URL and Search Query when set.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to return (hard cap for the run). If the category holds fewer products, the run logs a warning naming the real count.", "default": 100 }, "fetchDetails": { "title": "Fetch full product details", "type": "boolean", "description": "OFF by default. When ON, the actor opens every product's detail page to add EAN, description, full specs, categories, review count, and stock status. IMPORTANT: since late August 2026 Leroy Merlin's bot protection has blocked product detail pages on every route we have (measured again 2026-09-17: 0 of 6 pages returned content), so this flag currently returns listing-level fields only on most runs and costs extra time for nothing. Leave it OFF unless you are testing whether the block has lifted. A product whose detail page cannot be loaded is still returned with its listing-level fields, and the run log and status message name it.", "default": false }, "brightDataApiKey": { "title": "Bright Data API Key (optional)", "type": "string", "description": "OPTIONAL — the actor ships with a built-in Bright Data Web Unlocker integration, so you normally leave this empty. Provide your own Web Unlocker API key only if you want traffic billed to your own Bright Data account." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Used for category and product pages, which the actor loads in a real browser session. leroymerlin.fr geo-blocks non-French exits and DataDome scores datacenter ranges, so keep the default: Apify RESIDENTIAL proxy, country FR. Search pages go through the built-in Bright Data unlocker and do not use this proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }