{ "openapi": "3.0.1", "info": { "title": "ALDI UK Scraper: Prices, Price Drops & Specialbuys", "description": "Scrape ALDI UK (aldi.co.uk) products and prices: search, categories, Price Drops, Specialbuys with in-store dates, the whole range or product URLs. Gets price, was price, unit price, size, category and image. UK home connections. Failed lookups are free.", "version": "0.1", "x-build-id": "h7CVfq3mLuvdDVvXr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zaiq~aldi-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zaiq-aldi-uk-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~aldi-uk-scraper/runs": { "post": { "operationId": "runs-sync-zaiq-aldi-uk-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~aldi-uk-scraper/run-sync": { "post": { "operationId": "run-sync-zaiq-aldi-uk-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 aldi.co.uk, for example milk or air fryer.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category or Specialbuys URLs", "type": "array", "description": "ALDI UK category pages such as https://www.aldi.co.uk/products/chilled-food/milk/k/1588161416978051001, Specialbuys pages such as https://www.aldi.co.uk/special-buys/2026-10-08 (a theme in the address is kept), or category keys such as 1588161416978051001.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs or SKUs", "type": "array", "description": "Product pages such as https://www.aldi.co.uk/product/cowbelle-chocolate-milk-000000000000543221, or SKUs such as 000000000000543221. Up to 5,000.", "items": { "type": "string" } }, "specialBuys": { "title": "Specialbuys", "enum": [ "none", "all", "in-store", "upcoming" ], "type": "string", "description": "Read Specialbuys by their in-store date, as ALDI publishes them (usually the last two weeks and the next two drops). Each row has the in-store date as its offer start date.", "default": "none" }, "priceDrops": { "title": "Price Drops", "type": "boolean", "description": "Read ALDI's Price Drops page: products whose price was cut, with the previous price.", "default": false }, "wholeRange": { "title": "Whole range", "type": "boolean", "description": "Read every product aldi.co.uk lists (about 4,000 in October 2026). Set the maximum products to 0 or high enough.", "default": false }, "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 }, "includeDetails": { "title": "Add descriptions, ingredients and origin", "type": "boolean", "description": "Read each product's own record as well, for its description, ingredients, country of origin and allergens. One extra request per product; the price per product is the same.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "UK home (residential) connections are the default (Apify Proxy, group RESIDENTIAL, country GB). ALDI's product data answers any address with the same store prices, so if the proxy cannot be used or keeps failing, requests go direct.", "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 } } } } } } } } } }