# ALDI AU Scraper - Groceries, Special Buys & Prices (`abotapi/aldi-com-au-scraper`) Actor Scrape ALDI Australia (aldi.com.au) products: name, brand, price, was-price, savings, unit price, size, category, images, availability and Special Buys on-sale date, plus full detail (ingredients, allergens, nutrition). Search by keyword or category, filter by brand/theme, or paste any ALDI URL. - **URL**: https://apify.com/abotapi/aldi-com-au-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 product results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ALDI Australia Scraper Scrape the ALDI Australia catalogue - groceries, weekly ranges, and Special Buys - with prices and full product detail. Search by keyword or category, filter by brand and theme, or paste any ALDI product, category, or search link. Every record carries the product name, brand, price, unit (comparison) price, was-price and savings when a product is on offer, selling size, category, image gallery, availability, and Special Buys on-sale date. Turn on detail enrichment for the full description, ingredients, allergens, nutritional claims, storage and usage instructions, and country of origin. ### Why this scraper - Rich product records: 30 fields per catalogue item, up to 46 with detail enrichment - Three ways to collect: search by keyword, list a category (including Special Buys and weekly ranges), or paste ALDI URLs - Brand and theme filters, plus price and name ordering - Special Buys support out of the box - the "Special Buys", "Limited Time Only", "Lower Prices", and "Super Savers" ranges are all addressable as categories, with the on-sale date captured - Unit / comparison pricing ("$3.65 per 1 L") and was-price / savings surfaced when present - Optional detail enrichment: description, ingredients, allergens, nutritional claims, storage and usage instructions, country of origin, and the complete image gallery - Ready-to-download image URLs and a direct product URL on every record ### Data you get > Sample shape; values are illustrative placeholders, not from a live listing. | Field | Example | |---|---| | sku | `000000000000398949` | | name | `Full Cream Milk 2L` | | brand | `SAMPLE BRAND` | | price | `7.29` | | priceDisplay | `$7.29` | | wasPriceDisplay | `$8.99` | | savingsDisplay | `Save $1.70` | | onSale | `true` | | unitPrice | `3.65` | | unitPriceDisplay | `$3.65 per 1 L` | | currency | `AUD` | | sellingSize | `2 L` | | category | `Milk` | | categories | `[{"id":"960000000","name":"Dairy, Eggs & Fridge","path":"dairy-eggs-fridge"}]` | | onSaleDateDisplay | `On Sale Sat 5 Jul` | | images | `["https://.../product/jpg/scaleWidth/600//full-cream-milk-2l"]` | | imagesCount | `3` | | notForSale | `false` | | url | `https://www.aldi.com.au/product/full-cream-milk-2l-000000000000398949` | | description | `Full product description appears here when fetchDetails is on.` | | ingredients | `Full-cream milk.` | | allergens | `["Milk"]` | | nutritionalClaims | `Source of calcium` | | storageInstructions | `Keep refrigerated.` | | countryOrigin | `Australia` | | detailFetched | `true` | ### How to use Search by keyword: ```json { "mode": "search", "searchTerms": ["milk", "coffee"], "maxItems": 50 } ```` List a category (including Special Buys) with detail enrichment: ```json { "mode": "search", "categories": ["Special Buys", "Dairy, Eggs & Fridge"], "fetchDetails": true, "sortBy": "price_asc", "maxItems": 100 } ``` Filter a range by brand: ```json { "mode": "search", "categories": ["Limited Time Only"], "brands": ["URBAN EATS"], "maxItems": 30 } ``` Paste URLs (product, category, or search): ```json { "mode": "url", "urls": [ "https://www.aldi.com.au/products/dairy-eggs-fridge/milk/k/1111111160", "https://www.aldi.com.au/product/expressi-milk-frother-000000000000545135" ], "fetchDetails": true } ``` ### Input options - **mode** - `search` (keyword and/or category) or `url` (paste links) - **searchTerms** - keywords to search the catalogue (search mode) - **categories** - category names, URL slugs, or numeric keys; accepts `Special Buys`, `Limited Time Only`, `Lower Prices`, `Super Savers`, `Dairy, Eggs & Fridge`, `meat-seafood/beef`, etc. - **brands** - filter by brand name as shown on ALDI - **themes** - filter by ALDI theme label (e.g. `Pantry Staples`) - **sortBy** - `relevance` (default), `price_asc`, `price_desc`, or `name` - **urls** - ALDI product, category, or search URLs (url mode) - **fetchDetails** - add the full detail fields to every product (one extra request per product) - **maxItems** - cap on products across all terms/categories/URLs (0 = unlimited) - **maxPages** - optional safety cap on pages per term/category (60 products per page) - **proxy** - proxy configuration; the default works on any Apify plan ### Categories and Special Buys The `categories` input accepts the top-level ranges and any nested grocery aisle. The Special Buys / weekly-specials ranges are simply categories: - `Special Buys` / `Limited Time Only` - `Lower Prices` - `Super Savers` Grocery aisles can be given by name (`Dairy, Eggs & Fridge`), by slug (`dairy-eggs-fridge`, `dairy-eggs-fridge/milk`), or by the numeric key from a category URL. ### About product reviews ALDI Australia does **not** publish product reviews or star ratings on aldi.com.au. This was verified empirically: - No review or rating vendor (Bazaarvoice, Yotpo, PowerReviews, Feefo, Reevoo, or similar) is loaded anywhere on the product pages. - The product listing and product-detail responses that power the storefront contain no `rating`, `reviewCount`, `averageRating`, or review-body fields. Because the site does not expose reviews, this actor does not emit review fields. If ALDI adds reviews in future, this actor will be updated to capture them. ### Export to your apps (MCP connectors) Optionally pipe results into the apps you already use via Model Context Protocol (MCP) connectors - Notion, Linear, Airtable, or Apify. Authorize a connector once under Apify, Settings, Integrations, then select it in the input. The connector receives a condensed, human-readable summary per item; the full record always stays in the dataset. ### Output Every product is pushed to the dataset as a flat JSON record with the fields above. Use the **Products Overview** dataset view for a quick table, or export to JSON, CSV, or Excel from the Apify Console. ### Notes - Prices are in AUD. `price` and `unitPrice` are numeric dollars; the `*Display` fields carry the pre-formatted strings as shown on the site. - Was-price and savings appear only when a product is currently discounted. - The actor deduplicates by SKU within a run. # Actor input Schema ## `mode` (type: `string`): How to find products. 'search' builds listings from search terms and/or categories with filters; 'url' scrapes ALDI product, category or search URLs you paste. ## `searchTerms` (type: `array`): Keywords to search the ALDI catalogue, e.g. 'milk', 'coffee', 'air fryer'. Each term is paginated fully (up to Max products). Leave empty to use categories instead. ## `categories` (type: `array`): Category names or URL slugs to list, e.g. 'Special Buys', 'Limited Time Only', 'Lower Prices', 'Super Savers', 'Dairy Eggs & Fridge', 'meat-seafood/beef'. Also accepts a raw numeric category key. Special Buys and weekly-specials ranges are categories here. Leave empty to use search terms instead. ## `brands` (type: `array`): Filter by brand name as shown on ALDI, e.g. 'EXPRESSI', 'URBAN EATS'. Leave empty for all brands. ## `themes` (type: `array`): Filter by ALDI theme label, e.g. 'Pantry Staples', 'Limited Time Only Meat'. Leave empty for all. ## `sortBy` (type: `string`): Result ordering (search mode). ## `urls` (type: `array`): ALDI product, category or search page URLs to scrape (url mode). Category and search URLs return their full result set (up to Max products); product URLs return a single detail record. Filter fields are ignored in this mode. ## `fetchDetails` (type: `boolean`): Add full product-detail fields to every result: long description, ingredients, allergens, nutritional claims, usage and storage instructions, country of origin and the complete image gallery. Adds one request per product. ## `maxItems` (type: `integer`): Maximum number of products to scrape across all terms/categories/URLs. Set 0 for unlimited. ## `maxPages` (type: `integer`): Optional safety cap on the number of result pages per search term or category (60 products per page). Leave empty for no page limit; the run stops at Max products. ## `proxy` (type: `object`): Proxy used for requests. Any Apify proxy works; the default is fine for most runs. Runs on any Apify plan. ## `mcpConnectors` (type: `array`): Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "searchTerms": [ "milk" ], "sortBy": "relevance", "urls": [ "https://www.aldi.com.au/products/dairy-eggs-fridge/milk/k/1111111160" ], "fetchDetails": false, "maxItems": 20, "proxy": { "useApifyProxy": true }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "milk" ], "urls": [ "https://www.aldi.com.au/products/dairy-eggs-fridge/milk/k/1111111160" ], "proxy": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/aldi-com-au-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["milk"], "urls": ["https://www.aldi.com.au/products/dairy-eggs-fridge/milk/k/1111111160"], "proxy": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/aldi-com-au-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "milk" ], "urls": [ "https://www.aldi.com.au/products/dairy-eggs-fridge/milk/k/1111111160" ], "proxy": { "useApifyProxy": true } }' | apify call abotapi/aldi-com-au-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/aldi-com-au-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ALDI AU Scraper - Groceries, Special Buys & Prices", "description": "Scrape ALDI Australia (aldi.com.au) products: name, brand, price, was-price, savings, unit price, size, category, images, availability and Special Buys on-sale date, plus full detail (ingredients, allergens, nutrition). Search by keyword or category, filter by brand/theme, or paste any ALDI URL.", "version": "1.0", "x-build-id": "c6jSgrmELYAczDL65" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~aldi-com-au-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-aldi-com-au-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/abotapi~aldi-com-au-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-aldi-com-au-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/abotapi~aldi-com-au-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-aldi-com-au-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to find products. 'search' builds listings from search terms and/or categories with filters; 'url' scrapes ALDI product, category or search URLs you paste.", "default": "search" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search the ALDI catalogue, e.g. 'milk', 'coffee', 'air fryer'. Each term is paginated fully (up to Max products). Leave empty to use categories instead.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Category names or URL slugs to list, e.g. 'Special Buys', 'Limited Time Only', 'Lower Prices', 'Super Savers', 'Dairy Eggs & Fridge', 'meat-seafood/beef'. Also accepts a raw numeric category key. Special Buys and weekly-specials ranges are categories here. Leave empty to use search terms instead.", "items": { "type": "string" } }, "brands": { "title": "Brands", "type": "array", "description": "Filter by brand name as shown on ALDI, e.g. 'EXPRESSI', 'URBAN EATS'. Leave empty for all brands.", "items": { "type": "string" } }, "themes": { "title": "Themes", "type": "array", "description": "Filter by ALDI theme label, e.g. 'Pantry Staples', 'Limited Time Only Meat'. Leave empty for all.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc", "name" ], "type": "string", "description": "Result ordering (search mode).", "default": "relevance" }, "urls": { "title": "URLs", "type": "array", "description": "ALDI product, category or search page URLs to scrape (url mode). Category and search URLs return their full result set (up to Max products); product URLs return a single detail record. Filter fields are ignored in this mode.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Add full product-detail fields to every result: long description, ingredients, allergens, nutritional claims, usage and storage instructions, country of origin and the complete image gallery. Adds one request per product.", "default": false }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Maximum number of products to scrape across all terms/categories/URLs. Set 0 for unlimited.", "default": 20 }, "maxPages": { "title": "Max pages per term/category", "minimum": 0, "type": "integer", "description": "Optional safety cap on the number of result pages per search term or category (60 products per page). Leave empty for no page limit; the run stops at Max products." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for requests. Any Apify proxy works; the default is fine for most runs. Runs on any Apify plan." }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } }, "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 } } } } } } } } } } ```