# Woolworths Scraper - Grocery Products & Prices (`scrapesage/woolworths-scraper`) Actor

Scrape Woolworths Australia groceries: name, brand, price, was-price, specials, unit price, categories, nutrition, allergens, ingredients, health star rating, images, stock. Sort by price, specials only. No login, no key. Independent tool, not affiliated with Woolworths.

- **URL**: https://apify.com/scrapesage/woolworths-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 271 total users, 211 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.10 / 1,000 products

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

## Woolworths Scraper - Grocery Products & Prices

> **Disclaimer:** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Woolworths Group Limited or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. "Woolworths" is referenced only to describe the publicly available website this Actor collects data from.

Scrape grocery **products, prices and specials** from [Woolworths](https://www.woolworths.com.au) (Australia), with the full product card behind every result: **categories**, **images**, **ingredients**, **allergens**, **dietary claims**, the **nutrition panel**, **health star rating**, **promotions** and **purchase limits**. Search by term, sort by price or unit price, or keep only the specials. JSON, CSV or Excel. No login, no API key, no browser.

> **How it works:** it reads the Woolworths product-search API directly, so a run is fast and returns the same product data the site renders - for price monitoring, specials tracking, competitor and range analysis, FMCG research, nutrition and allergen datasets, and price-comparison tools.

### What you can scrape

- **Search products** by term - `milk`, `coffee`, `chicken breast` - across the full Woolworths catalogue, one record per product, with the total number of matches for the term.
- **Prices & promotions** - current price, was-price, savings, unit (cup) price, half-price and new-product flags, the promotion type and label (`Save $2.00`, `Everyday Low Price`), multi-buy offers (`2 for $10.00`) with their quantity and price, and the badges shown on the product tile.
- **Categories** - the department, category and subcategory the product sits in on the site, plus the merchandise category, subcategory and segment Woolworths files it under.
- **Images** - the main image and every additional product photo.
- **Ingredients, allergens & dietary claims** - the ingredient list, allergens the product contains or may contain, free-from claims, dietary and lifestyle claims (vegan, halal, gluten free, organic ...) and the health star rating.
- **Nutrition panel** - energy, protein, fat, saturated fat, carbohydrate, sugars, sodium and every other nutrient printed on the pack, per 100 g and per serve, with the serving size and servings per pack.
- **Availability & buying** - stock status, units remaining online, purchase limit, minimum quantity, whether it is sold each or by the kilo, delivery restrictions, and whether it ships from an Everyday Market seller (with the seller's name).
- **Sort & filter** - sort by relevance, price, unit price or name, and switch **Specials only** on to collect just the products currently on special.

Food products carry the ingredient, allergen, dietary and nutrition fields wherever Woolworths publishes them; non-food ranges (household, baby, pet) return the pricing, category, image and availability fields without them. Woolworths does not publish customer ratings on its search results, so records carry no star rating or review count.

### Output

One record per product. The original columns come first; every field added in the September 2026 update is appended after `scrapedAt`, so existing exports, integrations and saved tasks keep working and simply gain the new columns.

```json
{
  "type": "product",
  "name": "Primo Protein Roast Chicken Breast",
  "brand": "Primo",
  "price": 4.1,
  "wasPrice": 6.9,
  "onSale": true,
  "savings": 2.8,
  "packageSize": "150g",
  "cupPrice": 27.33,
  "cupMeasure": "1KG",
  "unitPriceLabel": "$27.33 / 1KG",
  "inStock": true,
  "stockcode": "6078152",
  "barcode": "9311594042224",
  "imageUrl": "https://cdn1.woolworths.media/content/wowproductimages/large/6078152.jpg",
  "url": "https://www.woolworths.com.au/shop/productdetails/6078152",
  "searchTerm": "chicken breast",
  "scrapedAt": "2026-09-16T23:49:02.861Z",
  "displayName": "Primo Protein Roast Chicken Breast 150g",
  "description": "Primo Protein Roast Chicken Breast delivers 16g of natural protein in tasty, ready to eat serves, making it effortless to enjoy quick, satisfying meals.",
  "variety": null,
  "departments": ["Lunch Box", "Deli"],
  "categories": ["Sandwich Ingredients", "Deli Meats"],
  "subcategories": ["Sliced & Shaved Meat", "Packaged Deli Meats"],
  "merchandiseCategory": "DELI CONVENIENCE",
  "merchandiseSubcategory": "DAIRY - SMALLGOODS",
  "merchandiseSegment": "SHAVED/SLICED MEATS 151G +",
  "images": ["https://cdn1.woolworths.media/content/wowproductimages/large/6078152.jpg", "https://cdn1.woolworths.media/content/wowproductimages/large/6078152_2.jpg"],
  "imageCount": 2,
  "ingredients": "Chicken, Seasoning Soy Protein, Maltodextrin (Maize or Tapioca), Modified Starch (1442 Maize or Tapioca), Tapioca Starch, Salt, Mineral Salts (451, 450), Natural Flavours, Vegetable Gum (407a), Dried Vegetables (Onion, Garlic), Preservative (223 Sulphites), Herb Extract, Spice Extract, Water, Acidity Regulators (326, 262), Egg.",
  "allergenContains": ["Egg", "Sulphites", "Soy"],
  "allergenMayContain": ["Milk"],
  "freeFromClaims": ["Fish Free", "Gluten Free", "No Artificial Colours or Flavours", "Wheat Free"],
  "dietaryClaims": ["Gluten Free", "High Protein", "Low Fat", "Low Sugar", "Source of Protein"],
  "healthStarRating": 3.5,
  "nutritionPer100g": { "carbohydrate": "5.5g", "energy": "520.0kJ", "fatSaturated": "1.0g", "fatTotal": "1.7g", "protein": "21.4g", "sodium": "806.0mg", "sugars": "2.3g" },
  "nutritionPerServe": { "carbohydrate": "4.1g", "energy": "390.0kJ", "fatSaturated": "< 1.0g", "fatTotal": "1.3g", "protein": "16.1g", "sodium": "605.0mg", "sugars": "1.7g" },
  "servingSize": "75.0 G",
  "servingsPerPack": 2,
  "storageInstructions": "Store at or below 4C. Consume immediately after opening.",
  "warnings": null,
  "isHalfPrice": false,
  "isNew": false,
  "promotionType": "Special",
  "promotionLabel": "Save $2.80",
  "offer": null,
  "offerUrl": null,
  "multibuyQuantity": null,
  "multibuyPrice": null,
  "badges": ["40% Off"],
  "soldBy": "Each",
  "minimumQuantity": 1,
  "purchaseLimit": 36,
  "stockRemaining": 7,
  "deliveryRestriction": null,
  "isMarketplaceItem": false,
  "marketplaceSeller": null,
  "searchResultsTotal": 119
}
```

### Example input

```json
{ "searchTerms": ["milk", "bread", "coffee"], "sortBy": "priceLowToHigh", "specialsOnly": false, "maxResults": 200 }
```

- `sortBy` - `relevance` (default), `priceLowToHigh`, `priceHighToLow`, `unitPriceLowToHigh` or `name`, applied within each search term exactly as the site sorts.
- `specialsOnly` - `true` returns only the products Woolworths currently lists under Specials (price drops, half price, multi-buy and everyday-low-price offers); combine with `onSale`, `isHalfPrice` and `promotionType` in the output to narrow further.

### Good to know

- Prices are the online prices shown on woolworths.com.au, in Australian dollars, at the time of the run.
- A run that finds nothing says so on the run card and names the search terms it tried, so a mistyped term is never mistaken for an empty catalogue.
- Nutrition values are kept exactly as printed on the pack (`"< 1.0g"`, `"1090.0kJ"`), so nothing is rounded or re-interpreted.

### Use with AI assistants (MCP)

Available through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp).

### Agent-ready: autonomous payments (x402 & Skyfire)

This actor is **agent-ready** - AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards:

- **[x402](https://docs.apify.com/platform/integrations/x402)** - an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) - no account, no API key.
- **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** - agent-to-service payments for fully autonomous AI-agent workflows.

### Pricing

Pay-per-event, tiered by volume: you pay per product returned, with no start fee and no monthly rental, and the price per product falls as your Apify plan tier rises. The current price is shown on the **Pricing** tab of this page. Every field described above, including the nutrition, allergen, category and promotion columns, is part of the same product event at no extra charge.

***

*This is an independent scraper for publicly available data. It is not affiliated with, endorsed by, or sponsored by Woolworths Group. "Woolworths" is a trademark of its respective owner, used here for descriptive purposes only. Use the data in compliance with the source's terms and applicable law.*

### Automate & schedule

Run this Actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** - start runs, fetch datasets and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** - official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** - run it hourly, daily or weekly and keep your dataset current.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** - trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/woolworths-scraper').call({
    "searchTerms": [
        "milk"
    ],
    "maxResults": 100
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} records`);
```

### Integrate with any app

Connect the dataset to thousands of apps - no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** - multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** - push new records straight into your CRM or spreadsheet.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** - get notified when a scheduled run finds something new.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** - auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** - pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** - trigger runs from commits or releases.

### More scrapers from scrapesage

Related Actors in the same category:

- **[Taobao & Tmall Scraper](https://apify.com/scrapesage/taobao-scraper)** - Products, Prices, Sellers & Reviews
- **[Kompass Scraper](https://apify.com/scrapesage/kompass-scraper)** - Global B2B Company & Supplier Leads
- **[Faire Scraper](https://apify.com/scrapesage/faire-scraper)** - Wholesale Brands, Supplier Leads & Products
- **[AliExpress Scraper](https://apify.com/scrapesage/aliexpress-scraper)** - Products, Prices, Orders & Supplier Leads
- **[GetYourGuide Scraper](https://apify.com/scrapesage/getyourguide-scraper)** - Tours, Activities, Prices & Reviews

### FAQ

**How is this Actor billed?** Pay-per-event: you pay only for the results it delivers, with no monthly rental and no start fee. The per-event price is shown on the Pricing tab.

**Can I schedule it and get results automatically?** Yes - create a [Schedule](https://docs.apify.com/platform/schedules) and add a [webhook](https://docs.apify.com/platform/integrations/webhooks) or an integration (Google Sheets, Slack, Make, Zapier) to push each run's dataset wherever you need it.

**Which export formats are available?** Every run's dataset can be downloaded as JSON, CSV, Excel (XLSX), XML, HTML or RSS from the Apify Console or the API.

**Can I run it from code or an AI agent?** Yes - through the [Apify API](https://docs.apify.com/api/v2) and client libraries, or from Claude, ChatGPT and other assistants via the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp).

**Is it legal to scrape Woolworths?** This Actor collects publicly available data only. You are responsible for using the output in compliance with applicable laws (including data-protection law where personal data is involved) and the source's terms. See the **Disclaimer** below.

**Is this an official Woolworths tool?** No. It is an independent, third-party Actor with no affiliation to, endorsement by or sponsorship from Woolworths Group Limited. See the **Disclaimer** below.

### Disclaimer

**This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Woolworths Group Limited or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.**

"Woolworths" and any related marks are the property of their respective owners and are used here only in a descriptive, nominative sense - to identify the publicly accessible website from which this Actor collects data. This Actor is not an official Woolworths product, is not authorised or certified by Woolworths Group Limited, and does not distribute Woolworths software. It collects only publicly available information; you are responsible for ensuring your use of that data complies with applicable laws, regulations and the terms of the source website.

### Need help?

Open an issue on the Actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome - this Actor is actively maintained.

# Actor input Schema

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

Product searches, e.g. <code>milk</code>, <code>coffee</code>, <code>chicken breast</code>. Each term is paged through separately.

## `sortBy` (type: `string`):

Order of the results within each search term, as Woolworths sorts them.

## `specialsOnly` (type: `boolean`):

Return only products Woolworths currently lists as specials: price drops, half price and multi-buy offers.

## `maxResults` (type: `integer`):

Maximum number of products to return across all search terms.

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

Proxies to use. The default Apify datacenter proxy is plenty.

## Actor input object example

```json
{
  "searchTerms": [
    "milk"
  ],
  "sortBy": "relevance",
  "specialsOnly": false,
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

All scraped product records as JSON items in the default dataset.

# 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"
    ],
    "maxResults": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

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

# Prepare the Actor input
run_input = {
    "searchTerms": ["milk"],
    "maxResults": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/woolworths-scraper").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"
  ],
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scrapesage/woolworths-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapesage/woolworths-scraper"
        }
    }
}
```

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/a56zaOSNjqyNtBEVd/builds/ts8o3YcIRrgSvvXTb/openapi.json