# AU Price Monitor | $1.70/1K product checks (`architekture/au-price-monitor`) Actor

Australian grocery price monitor for Coles, Woolworths and ALDI: watch products by name, barcode or URL, get one price snapshot per run with unit prices per kg or litre, price history, and drop, threshold and back-in-stock alerts by webhook or email.

- **URL**: https://apify.com/architekture/au-price-monitor.md
- **Developed by:** [architek.earth](https://apify.com/architekture) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.36 / 1,000 product checks

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/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

## AU Grocery Price Monitor API: Price History, Matching, Alerts

Free tier: watch up to 10 products weekly at Coles, Woolworths, ALDI and IGA, 4 runs per account, never charged. Give a postcode and Coles, Woolworths and IGA prices come from your nearest store; without one you get national online prices. Paid monitoring costs $0.0017 per product found at a chain, so 100 products checked daily at three chains costs about $12.50 a month, about $16 with IGA.

**Recorded run: 80 store-level price checks from 20 products at four chains in 130 seconds** (2026-11-15, postcode 2000, run `hSFgACfc9Aygcb5dk`). 61 of 80 matched at Coles Local Sydney CBD York Street, Woolworths Pyrmont Metro, Romeo's IGA Martin Place and ALDI national prices; a bounded weekly-basket sample.

architek.earth: an independent data studio. Pay-per-result scrapers with recorded runs, published canaries and stable schemas, built for people and AI agents.

Watch a list of groceries at Coles, Woolworths, ALDI and IGA Australia, at the stores near you. Each run saves one price snapshot per product and chain, names the store the price came from, with the unit price converted to one basis (per kg, per litre or per item) so chains compare directly. History stays in your account, and alerts fire when a price drops, crosses your threshold or comes back in stock.

### ✅ Why choose this scraper

#### Four chains, one list, your stores

Give products by name ("a2 full cream milk 2l"), barcode or product URL. Each run checks every product at every chain you pick and returns one row per product and chain. Set `postcode` and each chain's nearest store is used (Coles from 878 stores, Woolworths from 1,140, IGA from 555); set `stores` to pin exact store IDs. Every row carries `store` and `storeId`.

#### Unit prices you can compare

Coles quotes per litre, Woolworths often per 100 g, ALDI per 100 g or per kg. Every matched row carries `unitPriceStd` and `unitStd` (`kg`, `L` or `each`), so $0.95 per 100 g and $9.50 per kg both read as 9.50 per kg.

#### Matching you can audit

Barcodes match first. Otherwise names and pack sizes are compared and every match carries a `confidence` score and `matchMethod`. Different pack sizes (1L vs 2L), multipacks (650g x 2) and different variants (Light, Decaf, Brown) are not accepted as matches. Anything below your threshold comes back as `unmatched` with its best candidates, never silently dropped.

#### History and alerts without a database

Snapshots accumulate in a named dataset in your account, one per watchlist. Each row carries `previousPrice` and `change`. Alerts compare against the previous run: price drop of at least X%, price at or below a threshold, back in stock. Alerts land in the dataset and, if you want, at a webhook or an email address.

#### You pay for prices found, nothing else

One charge per product found at a chain. Unmatched products, a chain whose source failed, and free-tier runs cost nothing. A run with a failed source is marked `PARTIAL` and says which chain.

### ⚠️ Worth knowing up front

- **Store prices need a postcode.** Without `postcode` or `stores`, Coles and Woolworths rows are national online prices (no store chosen) and IGA is left out, because IGA prices exist only per store. With a postcode, prices are that store's shelf prices and can differ from the next suburb. ALDI prices are national: the same product had the same price at stores in six states, so ALDI rows always say "ALDI national price".
- Small CBD stores carry a smaller range, so more products come back unmatched there than at a full-size store.
- ALDI sells a smaller range, mostly its own brands, so branded products ("western star butter") often have no ALDI match. Give a generic name ("butter 500g") to compare ALDI's own brand.
- Generic names ("potatoes", "apples") match the closest product a chain sells, which may be loose produce at one chain and a bag at another. Compare `unitPriceStd`, or give brand and size ("bega peanut butter 470g") or a barcode.
- Prices are the online shelf prices each site shows. Multi-buy offers are reported in `promo`, never in `price`.
- One run takes about one to two minutes for 20 products; larger lists take longer. Schedule it yourself (daily or weekly) or use the example tasks.
- A run that stops early writes one free status row (`"recordType": "status"`) that says why. `RUN_SUMMARY` records every source run and the history dataset ID.

### ⚡ Try the example

Turn on `freeTier`, paste a list and start the run:

```json
{
  "products": ["a2 full cream milk 2l", "weet-bix 1.2kg", "white sugar 2kg", "tasty cheese 500g", "tim tam original"],
  "postcode": "2000",
  "watchlistName": "my-basket",
  "freeTier": true
}
```

#### Example task: weekly basket across Coles, Woolworths and ALDI

Twenty everyday products, national prices at three chains, weekly. Add `"postcode": "2000"` (or yours) for store prices at four chains. Schedule it on Monday mornings and compare `unitPriceStd` by `item` across chains.

```json
{
  "products": ["a2 full cream milk 2l", "helga's wholemeal bread", "western star butter 500g", "free range eggs 12 pack", "bananas", "weet-bix 1.2kg", "plain flour 2kg", "white sugar 2kg", "heinz baked beans 555g", "bega peanut butter 470g", "coca-cola 1.25l", "tetley tea bags", "nescafe blend 43 coffee", "long grain rice 1kg", "spaghetti 500g", "tasty cheese 500g", "frozen peas 1kg", "tim tam original", "apples", "potatoes"],
  "watchlistName": "weekly-basket",
  "frequency": "weekly",
  "freeTier": false
}
```

#### Example task: daily drop alerts on my 25 products

Your own 25 products, daily, with a 10% drop alert and a webhook.

```json
{
  "products": [{"name": "a2 full cream milk 2l", "maxPrice": 6.5}, {"barcode": "9310199012717"}, "western star butter 500g"],
  "watchlistName": "my-25",
  "frequency": "daily",
  "dropPercent": 10,
  "backInStock": true,
  "webhookUrl": "https://example.com/price-alerts",
  "freeTier": false
}
```

### ⚙️ Input

| Parameter | Type | Default | Description |
|---|---|---|---|
| `products` | array | prefilled basket | Up to 500. A name, or `{"name", "barcode", "url", "size", "maxPrice"}`. |
| `watchlistName` | string | `my-watchlist` | Names the history dataset and comparison store. Keep it the same across runs. |
| `postcode` | string | none | 4 digits. Coles, Woolworths and IGA use the nearest store; IGA is added to the default chains. |
| `stores` | object | `{}` | Store ID per chain, wins over the postcode, for example `{"coles": "0584", "woolworths-au": "1248", "iga": "127823"}`. |
| `chains` | array | Coles, Woolworths, ALDI (+ IGA with a store) | `coles`, `woolworths-au`, `aldi-au`, `iga`. |
| `frequency` | select | `weekly` | `weekly` or `daily`; the free tier is weekly. |
| `dropPercent` | integer | `10` | Alert on a drop of at least this percent since the previous run. `0` turns it off. |
| `priceAtOrBelow` | number | none | Alert when a price crosses to this level (AUD) or lower. Per-product `maxPrice` overrides it. |
| `backInStock` | boolean | `true` | Alert when a product that was unavailable or unmatched is found again. |
| `freeTier` | boolean | `false` (pre-selected in the form) | Up to 10 products, weekly, 4 runs per account, never charged. |
| `webhookUrl` | string | none | Alerts are POSTed here as JSON. |
| `notificationEmail` | string | none | Alerts are emailed here. |
| `matchThreshold` | number | `0.6` | Name and size matches below this confidence are reported as unmatched. |
| `candidatesPerProduct` | integer | `5` | Search results considered per product and chain. |
| `feedback` | string | none | Optional note for the maintainers. Read by a human; never changes output. |

### 🧱 Stable fields

Fields are only ever added, never renamed or removed.

| Field | Type | Meaning |
|---|---|---|
| `recordType` | string | `snapshot`, `alert` or `status`. |
| `watchId` | string | Stable ID of the watched product. |
| `item` | string | The product as you wrote it. |
| `chain` | string | Chain key, for example `coles`. |
| `chainLabel` | string | Chain name. |
| `status` | string | `matched`, `unmatched` or `source_failed`. |
| `confidence` | number | 1.0 for barcode or URL matches; otherwise the name and size score. |
| `matchMethod` | string | `barcode`, `url` or `name+size`. |
| `productId` | string | The chain's product ID. |
| `productName` | string | The chain's product name. |
| `size` | string | The chain's pack size. |
| `price` | number | Shelf price in AUD. |
| `unitPrice` | number | Unit price in AUD as the chain shows it. |
| `unitLabel` | string | The chain's unit basis, for example `1L` or `100 g`. |
| `unitPriceStd` | number | Unit price per 1 kg, per 1 L or per item. |
| `unitStd` | string | `kg`, `L` or `each`. |
| `wasPrice` | number | Price before a special, where published. |
| `promo` | string | Special, half price or multi-buy note. |
| `inStock` | boolean | Where the chain publishes stock. |
| `previousPrice` | number | Price in the previous run, when both matched. |
| `change` | number | `price - previousPrice`. |
| `productChanged` | boolean | True when a different product matched than last run; no comparison or price alert is made. |
| `url` | string | Product page. |
| `store` | string | The store the price came from (name and suburb), "national online price (no store chosen)" or "ALDI national price". |
| `storeId` | string | The chain's store ID, when a store was used. |
| `reason` | string | Why a row is unmatched, failed or partial. |
| `observedAt` | string | ISO timestamp of the run. |
| `rule`, `message` | string | On alert rows: `price_drop`, `price_at_or_below` or `back_in_stock`, and a readable message. |

### 📦 Output example

A matched row from run `XyTLFkCnbihkq3i6K`:

```json
{
  "recordType": "snapshot",
  "item": "plain flour 2kg",
  "chain": "aldi-au",
  "chainLabel": "ALDI",
  "status": "matched",
  "confidence": 0.887,
  "matchMethod": "name+size",
  "productName": "Plain Flour 2kg",
  "size": "2 kg",
  "price": 2.39,
  "unitPrice": 1.2,
  "unitLabel": "1 kg",
  "unitPriceStd": 1.2,
  "unitStd": "kg",
  "store": "ALDI national price",
  "observedAt": "2026-11-15T19:20:43+00:00"
}
```

An unmatched row keeps its candidates:

```json
{"recordType": "snapshot", "item": "weet-bix 1.2kg", "chain": "aldi-au", "status": "unmatched", "reason": "best candidate below 0.6", "candidates": [{"name": "Weet-Bix 375g", "price": 3.99, "confidence": 0.55}]}
```

### 🧠 Advanced usage

#### Price history for one product

Open the `historyDatasetId` from `RUN_SUMMARY` (dataset `au-price-monitor-<watchlistName>` in your storage) and filter by `watchId` and `chain`.

#### Cheapest chain per product

Within one run, group `snapshot` rows by `item` and take the lowest `unitPriceStd` among `matched` rows with the same `unitStd`.

#### Precise matching

Give barcodes where you have them, or a product URL from one chain plus a name. Raise `matchThreshold` to 0.8 to accept only close name and size matches.

### 🔌 Integrations

Snapshots and alerts are a standard dataset: download JSON, CSV or Excel, read them over the API, or trigger your own process from the webhook. A schedule makes the monitor hands-off.

### 💸 Pricing

| Event | Price | When |
|---|---|---|
| Product check | $0.0017 | One watched product found and priced at one chain in one run. |

100 products checked daily at three chains: about 245 matched checks per run, about $0.42 per run, about $12.50 a month. 25 products daily: about $3 a month. Unmatched products, failed sources, status rows and free-tier runs are free.

#### Store discounts

The primary `product-check` event keeps its full price for Free and Bronze users. Silver users receive 10% off; Gold, Platinum and Diamond users receive 20% off. Other event prices and free-preview limits are unchanged. The price applied to your run is shown in the Console.

### ❓ FAQ

#### Why did a product not match at a chain?

Either the chain does not sell it (ALDI carries few national brands), or the closest product is a different size, multipack or variant. The row lists the best candidates so you can refine the name.

#### Can I choose my store or postcode?

Yes. Set `postcode` for the nearest store at each chain, or `stores` for exact store IDs. ALDI has one national price, so it needs neither.

#### Can I watch New Zealand supermarkets?

Yes, with the NZ Price Monitor, which uses the same matching, history and alerts for six NZ chains.

#### Can an AI assistant run this?

Yes. AI assistants and agents can start it through the API with the JSON input above and read the snapshot and alert rows back; the stable fields and free status rows are designed for that.

### 🤖 For AI agents & LLM apps

Use the published input schema to provide a watchlist and a persistent state key. Inspect match confidence and source status before acting on a price alert. Keep the same state key on recurring runs to compare prices with the previous snapshot.

### 🧰 More from architek.earth

**Australian prices:** [Coles](https://apify.com/architekture/coles-au-product-scraper), [Woolworths AU](https://apify.com/architekture/woolworths-au-product-scraper), [ALDI AU](https://apify.com/architekture/aldi-au-product-scraper), [IGA AU](https://apify.com/architekture/iga-au-product-scraper), AU Price Monitor (this actor). Also: [NZ Price Monitor](https://apify.com/architekture/nz-price-monitor).

architek.earth · code like concrete

### 🙋 Support & legal

Questions or a product that will not match: open an issue on this page or use the `feedback` input. This monitor reads publicly available prices only, uses no login or account, and is not affiliated with the retailers.

architek.earth

### 📝 Changelog

- **2026-11-16**: IGA Australia Scraper is now public and linked from the footer.

- **2026-11-16**: Support approved primary-event Store discount tiers; retain exact event checks and existing preview limits.

- **2026-11-15**: 0.2 store prices. `postcode` and `stores` inputs choose Coles, Woolworths and IGA stores; IGA added as a fourth chain; every row names its store; stricter variant matching (Zero, Decaf, BBQ are not the watched product).

- **2026-11-15**: 0.1 first release. Coles, Woolworths and ALDI Australia, unit prices on one basis, barcode and name+size matching, history, drop, threshold and back-in-stock alerts, webhook and email delivery.

# Actor input Schema

## `products` (type: `array`):

Up to 500. Each is a name ("a2 full cream milk 2l") or an object {"name", "barcode", "url", "size", "maxPrice"}. Barcode matches first; otherwise name and size with a confidence score.

## `watchlistName` (type: `string`):

Names the history dataset and comparison store in your account. Keep it the same across runs to get history and alerts.

## `postcode` (type: `string`):

Optional. A 4-digit postcode: Coles, Woolworths and IGA prices come from the nearest store, and IGA is added. Blank = national online prices for Coles and Woolworths (no store chosen). ALDI prices are national either way.

## `stores` (type: `object`):

A store ID per chain, which wins over the postcode, for example {"coles": "0584", "woolworths-au": "1248", "iga": "127823"}.

## `chains` (type: `array`):

Which chains to check. Default: Coles, Woolworths and ALDI, plus IGA when a postcode or IGA store is given. IGA prices exist only per store.

## `frequency` (type: `string`):

How often you schedule this monitor. The free tier is weekly.

## `dropPercent` (type: `integer`):

Alert when a price falls by at least this much since the previous run. 0 turns it off.

## `priceAtOrBelow` (type: `number`):

Optional. Alert when a price crosses to this level or lower. Per-product maxPrice overrides it.

## `backInStock` (type: `boolean`):

Alert when a product that was unavailable or unmatched is found again.

## `freeTier` (type: `boolean`):

Up to 10 products, weekly, 4 runs per account, never charged. Turn off for paid monitoring.

## `webhookUrl` (type: `string`):

Alerts are POSTed here as JSON when any fire.

## `notificationEmail` (type: `string`):

Alerts are emailed here when any fire.

## `matchThreshold` (type: `number`):

Name and size matches below this confidence are reported as unmatched, with candidates.

## `candidatesPerProduct` (type: `integer`):

Search results considered per product and chain.

## `feedback` (type: `string`):

Tell us what you needed and did not get. Read by a human; never changes the output.

## Actor input object example

```json
{
  "products": [
    "a2 full cream milk 2l",
    "helga's wholemeal bread",
    "western star butter 500g",
    "free range eggs 12 pack",
    "bananas",
    "weet-bix 1.2kg",
    "white sugar 2kg",
    "heinz baked beans 555g",
    "bega peanut butter",
    "tim tam original"
  ],
  "watchlistName": "my-watchlist",
  "stores": {},
  "frequency": "weekly",
  "dropPercent": 10,
  "backInStock": true,
  "freeTier": true,
  "matchThreshold": 0.6,
  "candidatesPerProduct": 5
}
```

# Actor output Schema

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

No description

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

// Prepare Actor input
const input = {
    "products": [
        "a2 full cream milk 2l",
        "helga's wholemeal bread",
        "western star butter 500g",
        "free range eggs 12 pack",
        "bananas",
        "weet-bix 1.2kg",
        "white sugar 2kg",
        "heinz baked beans 555g",
        "bega peanut butter",
        "tim tam original"
    ],
    "freeTier": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("architekture/au-price-monitor").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 = {
    "products": [
        "a2 full cream milk 2l",
        "helga's wholemeal bread",
        "western star butter 500g",
        "free range eggs 12 pack",
        "bananas",
        "weet-bix 1.2kg",
        "white sugar 2kg",
        "heinz baked beans 555g",
        "bega peanut butter",
        "tim tam original",
    ],
    "freeTier": True,
}

# Run the Actor and wait for it to finish
run = client.actor("architekture/au-price-monitor").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 '{
  "products": [
    "a2 full cream milk 2l",
    "helga'\''s wholemeal bread",
    "western star butter 500g",
    "free range eggs 12 pack",
    "bananas",
    "weet-bix 1.2kg",
    "white sugar 2kg",
    "heinz baked beans 555g",
    "bega peanut butter",
    "tim tam original"
  ],
  "freeTier": true
}' |
apify call architekture/au-price-monitor --silent --output-dataset

```

## MCP server setup

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

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/wPI2oeAbcbeUYhUxn/builds/nd6mJMhbfXukOuDQD/openapi.json
