# Woolworths Australia Scraper — Products, Prices & Specials (`highbrow_fame/woolworths-au-products`) Actor

Woolworths Australia supermarket products and grocery prices: price, was-price, unit price, specials, barcode, ingredients, allergens and nutrition. Many searches and categories per run.

- **URL**: https://apify.com/highbrow\_fame/woolworths-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

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

## Woolworths Australia Scraper — Products, Prices & Specials

Get Woolworths Australia products with their shelf price, was-price, unit price, special offer, barcode, ingredients, allergens and full nutrition panel. Put in as many search words, category links and specials pages as you like — one run does them all.

**Why this one**

- 🛒 **Many searches in one run.** Type `milk`, `tim tam` and `coffee beans` on three lines, add the Half Price specials page and a category link, press Start. You get one list with every product labelled by the search or link it came from.
- 🔁 **Built to keep working.** It reads the same data the Woolworths website loads, through an Australian connection. A refused request waits and is retried on the same connection, never on a new IP. A live test on 28 September 2026 delivered 468 products in 5 runs with no failed request.
- 🥫 **Everything a price tracker needs, in every row.** Price, was-price, savings, the promotion as shown ("2 for $12.00", "Half Price", "Save $15.00"), unit price, stock status, barcode, category — plus ingredients, allergens and nutrition, with no extra requests.
- 🏷️ **Specials only, if you want.** Switch on **Only products on special** and everything at full price is skipped — and not charged.
- 💸 **You pay only for products delivered.** A search with no results, a wrong link or a page that fails after every retry comes back as a free record with the reason.

### What you get

For every product:

| Field | What it is |
|---|---|
| `name`, `brand`, `packageSize` | as on the shelf label |
| `price`, `wasPrice`, `savings` | current price, regular price, and the difference (AUD) |
| `isOnSpecial`, `isHalfPrice`, `promotion` | whether it is discounted, and the offer text |
| `unitPrice`, `unitMeasure`, `unitPriceText` | price per 100 g / 1 L / each, for comparing pack sizes |
| `instorePrice` | the in-store price Woolworths shows online |
| `isAvailable`, `isInStock` | availability online |
| `barcode`, `stockcode` | the EAN barcode and the Woolworths product number |
| `department`, `category` | where it sits in the store |
| `ingredients`, `allergensContains`, `allergensMayContain`, `lifestyle` | from the product label |
| `nutrition` | the nutrition panel, per 100 g and per serve |
| `healthStarRating` | Health Star Rating, when the product has one |
| `image`, `url` | 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 |

Not every product carries every label field: in the test run above, 100% had a price and a category, 84% a barcode, 74% ingredients and 69% a nutrition panel — the rest are items such as fresh produce, flowers or household goods that have no such label.

#### Example

A real record from a live run — search `milk`, 24 September 2026 (some fields and the nutrition panel left out here):

```json
{
  "input": "milk",
  "inputType": "search",
  "position": 7,
  "stockcode": 44528,
  "name": "Norco Full Cream Milk 2L",
  "brand": "Norco",
  "packageSize": "2L",
  "price": 4.5,
  "wasPrice": 5.05,
  "isOnSpecial": true,
  "savings": 0.55,
  "promotion": "Save $0.55",
  "unitPrice": 2.25,
  "unitMeasure": "1L",
  "unitPriceText": "$2.25 / 1L",
  "isInStock": true,
  "barcode": "9322042000048",
  "department": "Dairy, Eggs & Fridge",
  "category": "Full Cream Milk",
  "allergensContains": ["Milk"],
  "lifestyle": ["Gluten Free", "Low Salt", "Source of Protein", "Vegetarian"],
  "ingredients": "Pasteurised homogenised Milk",
  "nutrition": {
    "Energy kJ per 100g": "271.0kJ",
    "Protein per 100g": "3.3g",
    "Fat Total per 100g": "3.6g",
    "Sugars per 100g": "4.8g",
    "Serving Size": "250.0 ML"
  },
  "url": "https://www.woolworths.com.au/shop/productdetails/44528/norco-full-cream-milk",
  "status": "OK"
}
```

### How to use it

1. Add **Search words** — one per line, exactly what you would type into the Woolworths search box.
2. And/or add **Links** from woolworths.com.au:
   - a category or aisle, e.g. `https://www.woolworths.com.au/shop/browse/pantry`
   - a specials page, e.g. `https://www.woolworths.com.au/shop/browse/specials/half-price`
   - a search results page, or a single product page
3. Set **Max products per search or link** (a whole category can hold thousands).
4. Press **Start**, and download the results from the **Output** tab as JSON, CSV or Excel.

To track prices over time, save your input as a task and schedule it daily or weekly — 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 Woolworths pages and inputs that fail after every retry are free. With **Only products on special** on, skipped full-price 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 online prices Woolworths shows to a visitor who has not picked a store. In-store prices can differ by location; `instorePrice` is the in-store price Woolworths publishes online.

**A search came back as `NO_RESULTS`.** Woolworths 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 or specials page does not exist (any more). Open it on woolworths.com.au and copy the address again.

**Is this affiliated with Woolworths?** No. This is an independent tool that reads the product information Woolworths 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 Woolworths search box. One search per line — each one is a separate result list.

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

Any woolworths.com.au link: a category (/shop/browse/pantry), a specials page (/shop/browse/specials/half-price), a search results page or a single product (/shop/productdetails/…).

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

Stops each search or category after this many products. A category can hold thousands.

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

Keep only discounted products (half price, multibuy, price drops). The others are skipped and not charged.

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

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

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

Australian residential proxy by default: Woolworths refuses datacenter IPs.

## Actor input object example

```json
{
  "searchTerms": [
    "milk"
  ],
  "maxProductsPerInput": 50,
  "onlySpecials": 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/woolworths-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/woolworths-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/woolworths-au-products --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,highbrow_fame/woolworths-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/ZRdO2hiOU7sMLeUZj/builds/P9hfMxbZTM0T9dsqR/openapi.json