{ "openapi": "3.0.1", "info": { "title": "Aldi Scraper | European Grocery Prices", "description": "Scrape Aldi and Hofer across Europe, Germany's Aldi Nord and Aldi Süd included: prices, old prices, offer dates, price per kg or litre, brand, pack size and categories, as JSON. Whole catalogue, categories or search. No login, no proxy.", "version": "0.1", "x-build-id": "GWUmDDVJH7hRdb1Qh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ratatoskr~aldi-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ratatoskr-aldi-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/ratatoskr~aldi-scraper/runs": { "post": { "operationId": "runs-sync-ratatoskr-aldi-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/ratatoskr~aldi-scraper/run-sync": { "post": { "operationId": "run-sync-ratatoskr-aldi-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": { "shops": { "title": "Shops", "type": "array", "description": "Which Aldi shops to read. Germany has two separate companies, Aldi Nord and Aldi Süd, with their own ranges and prices. Pick several to compare them in one run. Category pages below name their own shop.", "items": { "type": "string", "enum": [ "be-nl", "be-fr", "fr", "de-nord", "de-sued", "nl", "lu", "es", "pt", "pl", "at", "ch", "gb", "ie", "it", "hu", "si" ], "enumTitles": [ "Belgium (Dutch)", "Belgium (French)", "France", "Germany, Aldi Nord", "Germany, Aldi Süd", "Netherlands", "Luxembourg", "Spain", "Portugal", "Poland", "Austria (Hofer)", "Switzerland (Aldi Suisse)", "United Kingdom", "Ireland", "Italy", "Hungary", "Slovenia (Hofer)" ] }, "default": [ "be-nl" ] }, "categories": { "title": "Category pages (optional)", "type": "array", "description": "Category page URLs from any Aldi or Hofer shop, such as https://www.aldi.be/producten/aardappelen-groenten-fruit/vers-fruit.html. Leave empty, with no search terms, for the whole catalogue.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms (optional)", "type": "array", "description": "Only products with all these words in their name, in the shop's language (e.g. koffie, or café for France).", "items": { "type": "string" } }, "promotionsOnly": { "title": "Promotions only", "type": "boolean", "description": "Only products with an old price or a promotion label.", "default": false }, "onSaleNowOnly": { "title": "On sale now only", "type": "boolean", "description": "Leave out prices that start on a later date. Off, you also get next week's offers, marked with upcoming: true.", "default": false }, "includeUnpriced": { "title": "Include products without a price", "type": "boolean", "description": "Also return products Aldi lists with no price on its site, with price empty. Off, only priced products are returned.", "default": false }, "maxItems": { "title": "Max products per shop, category or search term", "minimum": 1, "type": "integer", "description": "Stop after this many products for each shop, category or search term. Default 100; enter a higher number such as 100000 for everything.", "default": 100 } } }, "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 } } } } } } } } } }