# ALDI Australia Scraper — Products, Prices & Special Buys (`highbrow_fame/aldi-au-products`) Actor

ALDI Australia supermarket products and grocery prices: price, unit price, pack size, brand, category, Special Buys dates and Super Savers flags. Many searches and Special Buys pages per run.

- **URL**: https://apify.com/highbrow\_fame/aldi-au-products.md
- **Developed by:** [yestrue](https://apify.com/highbrow_fame) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 product delivereds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## ALDI Australia Scraper — Products, Prices & Special Buys

Get ALDI Australia products with their price, unit price, pack size, brand and category, plus which ones are Special Buys (with the on-sale date) and which sit on the Super Savers, Lower Prices and Limited Time Only shelves. Put in as many search words, category links and Special Buys pages as you like — one run does them all.

**Why this one**

- 🛒 **Many searches in one run.** Type `milk`, `coffee beans` and `nappies` on three lines, add the Special Buys page and a category link, press Start. You get one list with every product labelled by the search or link it came from.
- 📅 **Every coming Special Buy.** The Special Buys link walks every on-sale date ALDI lists — on 27 September 2026 that was 273 products on 5 dates; set the product limit to 300 or more to get them all. Every row carries its on-sale date.
- 🏷️ **Specials flagged on every row.** Each product says whether it is a Special Buy or on the Super Savers, Lower Prices or Limited Time Only shelf, so a plain search or category tells you what is on special too. Switch on **Only products on special** and everything else is skipped — and not charged.
- 🔁 **Built to keep working.** It reads the same product data the ALDI website loads. A live test run of 4 searches and links (plus 3 deliberately wrong inputs) delivered 3,392 products in 177 seconds, with no failed requests.
- 💸 **You pay only for products delivered.** A search with no results, a wrong link or a page that fails comes back as a free record with the reason.

### What you get

For every product:

| Field | What it is |
|---|---|
| `name`, `brand`, `packSize` | as on the shelf label |
| `price`, `priceText` | the current price (AUD), as a number and as shown |
| `unitPrice`, `unitMeasure`, `unitPriceText` | price per 100 g / 1 kg / 1 L, for comparing pack sizes |
| `isOnSpecial`, `promotions` | whether it is on special, and where: `Special Buys`, `Super Savers`, `Lower Prices`, `Limited Time Only` |
| `isSpecialBuy`, `specialBuyDate`, `specialBuyText` | for Special Buys: the on-sale date and ALDI's note ("On Sale Sat 03 Oct", "While Stocks Last") |
| `wasPrice`, `savingsText` | the earlier price and saving, when ALDI shows one |
| `department`, `category` | where it sits in the store |
| `ageRestriction`, `alcoholByVolume` | for liquor: the age limit (18) and the strength, when given |
| `isDiscontinued` | whether ALDI marks it as discontinued |
| `sku`, `image`, `url` | ALDI's product number, product image and page |
| `input`, `inputType`, `position` | which search or link it came from, and its place in that list |
| `scrapedAt` | when the row was read |
| `status`, `error` | `OK`, or why an input gave nothing |

With **Description, ingredients and storage** switched on, also `description`, `ingredients`, `storage` and `usage` from the product page.

In the test run above, 100% of products had a price, 94% a brand and 88% a pack size and unit price. The products without a category (13%) are all Special Buys, which ALDI files under their on-sale date instead. In a run with product pages, 98 of 99 products had a description, 29% ingredients and 35% storage notes — non-food Special Buys have no such label.

#### Example

A real record from a live run — the Meat & Seafood category with **Only products on special** and product pages on, 27 September 2026 (some fields left out and the long texts cut here):

```json
{
  "input": "https://www.aldi.com.au/products/meat-seafood/k/940000000",
  "inputType": "listing",
  "position": 61,
  "sku": "000000000000402201",
  "name": "Herb & Garlic Rissoles 540g",
  "brand": "READY, SET…COOK!",
  "packSize": "0.54 kg",
  "price": 4.99,
  "priceText": "$4.99",
  "wasPrice": null,
  "savingsText": null,
  "unitPrice": 9.24,
  "unitMeasure": "1 kg",
  "unitPriceText": "$9.24 per 1 kg",
  "isOnSpecial": true,
  "promotions": ["Super Savers"],
  "isSpecialBuy": false,
  "specialBuyDate": null,
  "specialBuyText": null,
  "department": "Meat & Seafood",
  "category": "Beef",
  "isDiscontinued": false,
  "url": "https://www.aldi.com.au/product/ready-set-cook-herb-garlic-rissoles-540g-000000000000402201",
  "description": "Herb and Garlic Rissoles are a savoury and aromatic dish combining ground meat with a delightful blend of fresh herbs and robust garlic. Perfect quick…",
  "ingredients": "Beef Mince (70%), Sausage Meat (28%) [Meat (Including Beef, Lamb & Chicken), Water, Rice Flour, Potato Starch, Salt, Mineral Salt (451), Preservative …",
  "storage": "Chilled: Keep refrigerated. Store below 4°C.",
  "status": "OK"
}
```

### How to use it

1. Add **Search words** — one per line, exactly what you would type into the ALDI search box.
2. And/or add **Links** from aldi.com.au:
   - a category, e.g. `https://www.aldi.com.au/products/dairy-eggs-fridge/k/960000000` — a brand filter or sort order in the link is kept
   - the Special Buys page `https://www.aldi.com.au/special-buys` (every coming on-sale date), or one date, e.g. `https://www.aldi.com.au/special-buys/2026-10-03`, with or without `?theme=BBQ`
   - `https://www.aldi.com.au/products` for the whole range (about 3,200 products)
   - a single product page
3. Set **Max products per search or link**.
4. Press **Start**, and download the results from the **Output** tab as JSON, CSV or Excel.

To track prices or catch the new Special Buys every week, save your input as a task and schedule it — every row carries `scrapedAt`.

You can also call it from the Apify API, from Make, Zapier or n8n, or from an AI agent through the Apify MCP server.

### Pricing

You are charged **per product delivered** — see the price on this page. Searches with no results, links that are not ALDI pages and inputs that fail are free. With **Only products on special** on, skipped products are free too. If your run has a **Maximum charge**, the Actor stops cleanly when it is reached and tells you how many searches or links were left.

### FAQ

**Which prices are these?** The prices ALDI Australia shows on its website. ALDI sells in store only, so there is no online price, delivery fee or stock level.

**Why is `wasPrice` empty?** ALDI rarely shows an earlier price: on 27 September 2026 none of the 3,190 products in its range had one. Its price cuts show up as the Lower Prices and Super Savers shelves, which `promotions` names.

**Is there a barcode, nutrition panel or allergen list?** No. ALDI's website publishes no barcode and shows the nutrition panel only as a picture. ALDI's product data does carry "contains / may contain" notes, but the website does not show them and they do not match the products (100% beef mince "contains gluten"), so they are left out. Always check the pack for allergens.

**A search came back as `NO_RESULTS`.** ALDI shows no products for it. With **Only products on special** on, it means none of the products found is on special right now — the error says how many were found. You were not charged.

**A link came back as `NOT_FOUND`.** The category, product or Special Buys date does not exist (any more). ALDI lists Special Buys only for the coming weeks; open the Special Buys page on aldi.com.au for the current dates.

**Is this affiliated with ALDI?** No. This is an independent tool that reads the product information ALDI publishes on its website.

**Like it?** A short review on the Store page helps other people find this Actor. Something missing or broken? Tell us on the Issues tab — we read every one.

# Actor input Schema

## `searchTerms` (type: `array`):

What you would type into the ALDI search box. One search per line — each one is a separate result list.

## `urls` (type: `array`):

Any aldi.com.au link: a category (/products/dairy-eggs-fridge/k/960000000, brand and sort filters are kept), the Special Buys page (/special-buys) or one on-sale date (/special-buys/2026-10-03), all products (/products) or a single product (/product/…).

## `maxProductsPerInput` (type: `integer`):

Stops each search or link after this many products. The whole ALDI range is about 3,200 products.

## `onlySpecials` (type: `boolean`):

Keep only Special Buys and products on the Super Savers, Lower Prices and Limited Time Only shelves. The others are skipped and not charged.

## `includeDetails` (type: `boolean`):

Also open every product page for its description, ingredients, storage and usage notes. Slower: one extra request per product.

## `maxConcurrency` (type: `integer`):

How many searches or links to work on at the same time.

## `proxyConfiguration` (type: `object`):

Australian residential proxy by default: ALDI refuses datacenter IPs.

## Actor input object example

```json
{
  "searchTerms": [
    "milk"
  ],
  "maxProductsPerInput": 50,
  "onlySpecials": false,
  "includeDetails": false,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "AU"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Every result as a JSON record, with a status for each input.

## `resultsCsv` (type: `string`):

The same records as CSV, for a spreadsheet.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "milk"
    ],
    "maxProductsPerInput": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "AU"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("highbrow_fame/aldi-au-products").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["milk"],
    "maxProductsPerInput": 50,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "AU",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("highbrow_fame/aldi-au-products").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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"
  ],
  "maxProductsPerInput": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "AU"
  }
}' |
apify call highbrow_fame/aldi-au-products --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,highbrow_fame/aldi-au-products"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/PeolyPRyUmsSKRYrS/builds/l3obf1CWOmb8bdIzt/openapi.json