ALDI Australia Products, Prices & Special Buys Scraper

Extract live, structured data from ALDI Australia for product research, price monitoring, catalog analysis, Special Buys tracking, APIs and automated AI workflows. The Actor supports buyer-facing search, exact product lookup, category discovery, category browsing, current search capabilities and the live Special Buys calendar.

This is an unofficial Actor and is not affiliated with or endorsed by ALDI.

What you get

Product records can include the ALDI product ID and slug, name, brand, displayed price in AUD, comparable unit price, pack size, availability signals, description, breadcrumbs, images and the canonical source URL. Special Buys rows add the advertised event date, weekday, theme and promotion context when the public site exposes them.

Every Dataset row is self-describing with record_type, operation, retrieved_at, source and country. Product rows use currency: "AUD". This makes mixed operations predictable for scripts, MCP clients and AI agents.

Operations

Operation	Purpose	Required input
search	Search the live ALDI buyer-facing results route	query
item	Resolve one exact product with rich PDP data	itemId or itemSlug
categories	Discover current category URLs and IDs	none
category	Browse products from a discovered category	categoryUrl or categoryId
search_filters	Return supported sort and filter capabilities	none
special_events	Discover currently advertised Special Buys dates and themes	none
specials	Fetch products for a live Special Buys event	eventDate; optional theme

Quick start

The default configuration is a rich buyer search:

{
  "operation": "search",
  "query": "milk",
  "page": 1,
  "limit": 10,
  "sort": "relevance",
  "details": true
}

IDs are strings and can contain leading zeros. Feed the returned ID back to item unchanged:

{
  "operation": "item",
  "itemId": "000000000000380234"
}

For category workflows, run categories, take a returned source_url, then pass it as categoryUrl. For Special Buys, run special_events first; it returns the dates and themes currently advertised by ALDI, which can be supplied directly to specials.

Output contract and AI use

The default Dataset is the primary result surface. search, item, category and specials emit record_type=product; categories emits record_type=category; special_events emits record_type=special_event; and search_filters emits one record_type=search_filters capability row instead of an empty Dataset. The Actor output schema links directly to the Dataset API and to the OUTPUT key-value-store record.

OUTPUT includes operation status, row count, errors, supported operations and runtime metadata. Together with the input and Dataset schemas, this allows API clients and agents to discover how to call the Actor and interpret results without relying on prose-only conventions.

Freshness and limitations

Data is fetched live from public ALDI Australia web surfaces at run time. Prices, range and availability can change and may vary between stores. Special Buys are time-sensitive and available while stocks last. Use special_events rather than hard-coding old dates.

details=true opens product pages and performs more requests, but returns a richer product record. Search relevance follows ALDI's current site behavior. Use reasonable collection sizes and comply with applicable terms and laws when using the data.