{ "openapi": "3.0.1", "info": { "title": "ALDI US Scraper: Store Prices, ALDI Finds & Weekly Ad", "description": "Get ALDI US products with the price at your store: regular price, Price Drops and weekly ad deals with dates, ALDI Finds, unit price, stock, size and category. Search, categories or product links by ZIP or store. Pairs with our ALDI Australia Scraper. About $0.0035 per product. No login.", "version": "1.0", "x-build-id": "cEnleGNZFfczNY3Wd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vant47~aldi-us-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vant47-aldi-us-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/vant47~aldi-us-scraper/runs": { "post": { "operationId": "runs-sync-vant47-aldi-us-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/vant47~aldi-us-scraper/run-sync": { "post": { "operationId": "run-sync-vant47-aldi-us-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": "Find products such as milk, chicken or coffee. Each term is searched at every selected store. Leave empty when using only URLs or product IDs.", "items": { "type": "string" } }, "startUrls": { "title": "Category, deals or product URLs", "type": "array", "description": "ALDI US category pages, collections, weekly ads or product links. Explicit ZIPs and store IDs control prices.", "items": { "type": "string" } }, "productIds": { "title": "Product IDs", "type": "array", "description": "Optional numeric ALDI product IDs, such as 18649227. These are product IDs, not UPCs.", "items": { "type": "string" } }, "locations": { "title": "ZIP codes", "type": "array", "description": "Use US ZIP codes, such as 94611 or 20037. Chooses the nearest store of the selected banner. Empty means the website default store.", "items": { "type": "string" } }, "storeIds": { "title": "Store IDs", "type": "array", "description": "Exact public ALDI retailer location IDs, such as 23593. These take precedence over ZIPs. Every store and in-store price list is verified.", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Maximum products per search and store", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum new product rows from each term, category or deals source at one store. Duplicates are free.", "default": 20 }, "maxItems": { "title": "Maximum products in this run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Global limit across product and store observations. About $0.0035 per product: 20 products cost $0.07 plus the small start fee.", "default": 20 }, "dealsOnly": { "title": "Deals only", "type": "boolean", "description": "Keep source markdowns, Price Drops and weekly-ad products. ALDI Finds alone are not automatically a discount.", "default": false }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Slower optional product metadata such as ingredients and nutrition. No extra product fee. Missing details remain null; store prices are always verified independently.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Default datacenter pool first, then US residential after refusal. Fresh anonymous visitor sessions only.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }