# ALDI Australia Scraper (`solidcode/aldi-com-au-scraper`) Actor \[💰 $2.5 / 1K] Extract product, pricing, and availability data from ALDI Australia (aldi.com.au). Search by keyword or paste category and product URLs to collect names, brands, prices, price-per-unit, pack sizes, special-buy promotions, images, and stock status. - **URL**: https://apify.com/solidcode/aldi-com-au-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (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 $2.50 / 1,000 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 Pull the entire ALDI Australia grocery catalogue at scale — product names, AUD prices, was-prices, special-buy promotions, unit pricing, pack sizes, brands, images, categories, and stock flags, one clean row per product. Search by keyword or paste any aldi.com.au URL, sort five ways, and collect unlimited results. Built for grocery price analysts, retail intelligence teams, and deal aggregators who need fresh ALDI AU pricing without manually clicking through the online catalogue page by page. ### Why This Scraper? - **Keyword search OR URL input** — type "tim tams", "milk", or "olive oil" and get matching products instantly. The leading alternative is URL-only, forcing you to hand-build category links; here you search like a shopper. - **Special-buy & on-sale detection** — every discounted product is flagged with `onSale: true` plus the original `wasPrice`, so you can isolate ALDI's rotating Special Buys and weekly specials in one pass. - **True unit-price comparison** — `pricePerUnit` is normalized ALDI's way (e.g. "$1.71 per 100 g"), letting you compare cost-per-gram across pack sizes instead of just sticker price. - **Full AUD pricing on every row** — current price, was-price, and currency code (AUD) captured for each product, ready for spreadsheets and price-tracking dashboards. - **Five sort orders** — Best match, Name A–Z, Name Z–A, Price low→high, and Price high→low, so the cheapest unit prices or newest deals surface first. - **Brand, pack size & age-restriction flags** — `brand`, `packSize`, and an `ageRestricted` flag (alcohol and restricted items) on every product, not just a name and price. - **Product images, hi-res** — primary `imageUrl` plus a full `images[]` gallery delivered at 600px, ready to drop into a catalogue feed or content site. - **Unlimited results** — set `maxResults: 0` to capture an entire category or search; no 20-item ceiling, no pagination links to chase. - **Whole-catalogue coverage** — works across every ALDI Australia category from pantry and fresh produce to Special Buys, with SKU, categories path, and promotional badges on each row. ### Use Cases **Grocery Price Monitoring & Competitive Retail Intelligence** - Track ALDI AU shelf prices over time to benchmark against Coles, Woolworths, and IGA - Compare cost-per-unit across brands and pack sizes using `pricePerUnit` - Detect price drops by watching `price` against `wasPrice` - Feed live AUD pricing into internal pricing and margin models **Promotion & Special-Buys Tracking** - Capture every `onSale` product the moment a new weekly special goes live - Archive ALDI's rotating Special Buys catalogue before items sell out - Measure discount depth from the `wasPrice` → `price` delta - Surface promotional `badges` for campaign and merchandising analysis **Market Research** - Map ALDI's private-label range by brand and category - Size up an entire category with `maxResults: 0` for share-of-shelf analysis - Spot newly listed and discontinued products via the `inStock` and `discontinued` flags - Compare assortment breadth across pantry, fresh, frozen, and household categories **Product Catalogue & Content Feeds** - Build a structured ALDI AU product feed with images, SKUs, and category paths - Power price-comparison sites and shopping apps with normalized unit pricing - Keep an internal product database in sync with current names, sizes, and prices - Generate image-rich content listings from the 600px `images[]` gallery **Deal & Coupon Aggregators** - Auto-publish the latest ALDI specials to deal sites and newsletters - Filter to discounted products only by checking the `onSale` flag - Rank deals by savings using the `wasPrice` minus `price` difference - Alert subscribers when a watched keyword product goes on special ### Getting Started #### Simple Keyword Search Just name a product — no URLs required: ```json { "searchTerms": ["tim tams"] } ```` #### Multiple Searches, Cheapest First Search several products at once and surface the lowest unit prices first: ```json { "searchTerms": ["olive oil", "milk", "coffee"], "sortBy": "price_asc", "maxResults": 50 } ``` #### Whole Category from a URL Paste any ALDI Australia category, product, or search URL — filters already in the URL are applied automatically. Set `maxResults` to 0 to capture the full category: ```json { "startUrls": [ "https://www.aldi.com.au/products/pantry/" ], "maxResults": 0 } ``` #### Advanced — Keywords and URLs Combined Mix keyword searches with pasted URLs in a single run: ```json { "searchTerms": ["dark chocolate", "sparkling water"], "startUrls": [ "https://www.aldi.com.au/products/pantry/", "https://www.aldi.com.au/results?q=chips" ], "sortBy": "name_asc", "maxResults": 200 } ``` ### Input Reference #### What to Scrape | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchTerms` | string\[] | `["tim tams"]` | Products to search for on ALDI Australia, one per line (e.g. "tim tams", "milk", "olive oil"). Each term runs as its own search. | | `startUrls` | string\[] | `[]` | Paste ALDI Australia category, product, or search-result URLs (e.g. https://www.aldi.com.au/products/pantry/). Any filters already in the URL are applied automatically. Leave empty if you only use Search Terms. | #### Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxResults` | integer | `100` | Maximum number of products to collect for each search term or URL. Set to 0 for no limit. Tip: start with 20–50 to test, then increase. | | `sortBy` | select | `Best match` | How to order products within each search or category: **Best match**, **Name (A to Z)**, **Name (Z to A)**, **Price (low to high)**, or **Price (high to low)**. | ### Output Every product is one flat row. Here's a representative result: ```json { "sku": "000000000000704511", "name": "Belmont Choc Tim Tam Original Biscuits 200g", "brand": "Belmont", "price": 3.49, "wasPrice": 3.99, "onSale": true, "pricePerUnit": "$1.75 per 100 g", "packSize": "200g", "currency": "AUD", "categories": ["Pantry", "Biscuits & Crackers"], "imageUrl": "https://dm.cms.aldi.cx/is/image/prod1amer/product/jpg/scaleWidth/600/tim-tam-original-200g", "images": [ "https://dm.cms.aldi.cx/is/image/prod1amer/product/jpg/scaleWidth/600/tim-tam-original-200g" ], "inStock": true, "discontinued": false, "ageRestricted": false, "badges": ["Special Buy"], "productUrl": "https://www.aldi.com.au/product/belmont-choc-tim-tam-original-biscuits-200g-000000000000704511", "searchTerm": "tim tams", "sourceUrl": null } ``` #### Product & Pricing | Field | Type | Description | |-------|------|-------------| | `sku` | string | ALDI product identifier (SKU) | | `name` | string | Full product name | | `brand` | string | Brand name (often an ALDI private label) | | `price` | number | Current price in AUD | | `wasPrice` | number | Previous strike-through price when on special | | `onSale` | boolean | True when the product is a current special or Special Buy | | `pricePerUnit` | string | Normalized unit price for comparison (e.g. "$1.71 per 100 g") | | `packSize` | string | Selling size / pack quantity (e.g. "200g", "6 pack") | | `currency` | string | Currency code (always AUD) | #### Catalogue & Media | Field | Type | Description | |-------|------|-------------| | `categories` | string\[] | Category path the product belongs to | | `imageUrl` | string | Primary product image URL (600px) | | `images` | string\[] | All product image URLs (600px) | | `badges` | string\[] | Promotional badges (e.g. "Special Buy") | | `productUrl` | string | Canonical ALDI Australia product page URL | #### Availability & Source | Field | Type | Description | |-------|------|-------------| | `inStock` | boolean | Whether the product is currently available | | `discontinued` | boolean | Whether the product is discontinued | | `ageRestricted` | boolean | Age-restricted flag (alcohol and restricted items) | | `searchTerm` | string | The search term that produced this row (null for URL input) | | `sourceUrl` | string | The input URL this row came from (null for keyword search) | ### Tips for Best Results - **Test small, then scale** — set `maxResults` to 20–50 on your first run to confirm the data matches what you need, then raise it or set 0 for everything. - **Capture a full category with `maxResults: 0`** — paste a category URL and set the cap to 0 to collect every product in that category, then pair it with `price_asc` sort to surface the cheapest unit prices first. - **Isolate deals with the `onSale` flag** — after a run, filter rows where `onSale` is true to get just the current specials and Special Buys, then sort by the `wasPrice` − `price` gap to rank by savings. - **Compare cost-per-unit, not sticker price** — use `pricePerUnit` rather than `price` when benchmarking across brands; a larger pack often wins on cost-per-100g even at a higher shelf price. - **Run keyword searches for moving targets** — keyword searches always reflect the live range, so they catch newly added products and weekly specials that fixed category URLs can miss. - **Combine keywords and URLs in one run** — mix `searchTerms` and `startUrls` together to cover specific products and whole categories in a single pass. - **Use sort to shape your dataset** — `name_asc` keeps catalogue exports tidy and stable, while `price_desc` surfaces premium products first for assortment analysis. ### Pricing **From $2.50 per 1,000 results** — among the most affordable ALDI Australia product extractors available, undercutting comparable tools. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier. | Results | No discount | Bronze | Silver | Gold | |---------|-------------|--------|--------|------| | 100 | $0.30 | $0.29 | $0.27 | $0.25 | | 1,000 | $3.00 | $2.85 | $2.65 | $2.50 | | 10,000 | $30.00 | $28.50 | $26.50 | $25.00 | | 100,000 | $300.00 | $285.00 | $265.00 | $250.00 | A "result" is any product row in the output dataset. The small per-run start fee and any platform fees (storage) are additional and depend on your Apify plan. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate price research, market analysis, and product catalogue work. You are responsible for complying with applicable laws and ALDI Australia's Terms of Service. Collect only publicly available product information, do not overload the source site, and do not use the data for any unlawful or deceptive purpose. # Actor input Schema ## `searchTerms` (type: `array`): Products to search for on ALDI Australia, one per line (e.g. 'tim tams', 'milk', 'olive oil'). Each term runs as its own search. ## `startUrls` (type: `array`): Paste ALDI Australia category, product, or search-result URLs (e.g. https://www.aldi.com.au/products/pantry/). Any filters already in the URL are applied automatically. Leave empty if you only use Search Terms above. ## `maxResults` (type: `integer`): Maximum number of products to collect for each search term or URL. Set to 0 for no limit. Tip: start with 20-50 to test, then increase. ## `sortBy` (type: `string`): How to order the products within each search or category. ## Actor input object example ```json { "searchTerms": [ "tim tams" ], "startUrls": [], "maxResults": 100, "sortBy": "relevance" } ``` # Actor output Schema ## `products` (type: `string`): Table of ALDI Australia products with name, brand, price, price-per-unit, pack size, sale status, and availability. # 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": [ "tim tams" ], "startUrls": [], "maxResults": 100, "sortBy": "relevance" }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/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": ["tim tams"], "startUrls": [], "maxResults": 100, "sortBy": "relevance", } # Run the Actor and wait for it to finish run = client.actor("solidcode/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": [ "tim tams" ], "startUrls": [], "maxResults": 100, "sortBy": "relevance" }' | apify call solidcode/aldi-com-au-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/aldi-com-au-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ALDI Australia Scraper", "description": "[💰 $2.5 / 1K] Extract product, pricing, and availability data from ALDI Australia (aldi.com.au). Search by keyword or paste category and product URLs to collect names, brands, prices, price-per-unit, pack sizes, special-buy promotions, images, and stock status.", "version": "1.0", "x-build-id": "9Ay0h3EEhpMEwS1Pk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~aldi-com-au-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~aldi-com-au-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~aldi-com-au-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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", "properties": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "Products to search for on ALDI Australia, one per line (e.g. 'tim tams', 'milk', 'olive oil'). Each term runs as its own search.", "items": { "type": "string" } }, "startUrls": { "title": "ALDI Australia URLs", "type": "array", "description": "Paste ALDI Australia category, product, or search-result URLs (e.g. https://www.aldi.com.au/products/pantry/). Any filters already in the URL are applied automatically. Leave empty if you only use Search Terms above.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results Per Search", "minimum": 0, "type": "integer", "description": "Maximum number of products to collect for each search term or URL. Set to 0 for no limit. Tip: start with 20-50 to test, then increase.", "default": 100 }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "name_asc", "name_desc", "price_asc", "price_desc" ], "type": "string", "description": "How to order the products within each search or category.", "default": "relevance" } } }, "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 } } } } } } } } } } ```