{ "openapi": "3.0.1", "info": { "title": "Lidl GB Scraper: Prices, Lidl Plus & Weekly Offers", "description": "Scrape Lidl GB (lidl.co.uk) products and prices: weekly food offers, Lidl Plus prices with their dates, Middle of Lidl specials, search, pages, the whole published range or product URLs. Gets price, Lidl Plus price, unit price and in-store dates. UK home connections.", "version": "0.1", "x-build-id": "G6AnsKvSgR716RRlo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zaiq~lidl-gb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zaiq-lidl-gb-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/zaiq~lidl-gb-scraper/runs": { "post": { "operationId": "runs-sync-zaiq-lidl-gb-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/zaiq~lidl-gb-scraper/run-sync": { "post": { "operationId": "run-sync-zaiq-lidl-gb-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Words to search for on lidl.co.uk, for example chocolate or air fryer. When Lidl answers a search with an offer page, that page's products are returned.", "items": { "type": "string" } }, "weeklyOffers": { "title": "Weekly offers", "type": "boolean", "description": "Read every offer page linked from Lidl's Food Offers and Middle of Lidl pages: Lidl Plus offers (current and upcoming), Pick of the Week, themed food weeks and Middle of Lidl specials.", "default": false }, "wholeRange": { "title": "Whole published range", "type": "boolean", "description": "Read every product lidl.co.uk lists (about 700 in October 2026; Lidl GB does not sell groceries online, so the site shows a changing selection).", "default": false }, "categoryUrls": { "title": "Page URLs", "type": "array", "description": "Lidl GB category or offer pages such as https://www.lidl.co.uk/h/food-cupboard/h10096095 or https://www.lidl.co.uk/c/lidl-plus-offers-current/a10053222.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs or IDs", "type": "array", "description": "Product pages such as https://www.lidl.co.uk/p/belbake-milk-chocolate-chips/p10055452, or product IDs such as 10055452. Up to 5,000.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum products", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "The run stops after writing this many products. 0 means no limit. Each product is written and charged once, even when several inputs find it.", "default": 100 }, "offersOnly": { "title": "Only products on offer", "type": "boolean", "description": "Keep only products with a promotion, a lower price than before, or a member price. Products left out are not charged.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "UK home (residential) connections work best; Apify Proxy, group RESIDENTIAL, country GB is the default. Every connection is checked to be in Great Britain before use.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }, "maxConcurrency": { "title": "Requests at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many inputs are worked on at the same time. The site is never sent more than this many requests at once.", "default": 4 } } }, "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 } } } } } } } } } }