Woolworths Scraper: Grocery Prices, Specials and Reviews

Woolworths Scraper turns the Woolworths Australia online supermarket into structured grocery data. Search by keyword, browse a whole specials category, or paste product, category, specials or search links (or bare product codes), and get back price, was price and savings, unit price, pack size, stock and availability, images, department, nutrition, ingredients, allergens, health star rating, and customer ratings and reviews. Export to JSON, CSV or Excel, or pull results straight into your app through the API.

Why This Scraper?

• Three ways to start. Search by keyword with filters, browse a whole Woolworths specials category, or paste product, category, specials or search links, including bare numeric product codes.
• Full price picture. Current price, strike-through was price, savings amount and percentage, unit (cup) price, offer label, and multibuy or member-price details when they apply.
• A separate in-store price. Woolworths prices delivery/pickup and in-store purchases as two independent offers on the same product; this actor returns both, with no extra request needed.
• Deep specials coverage. Walk any single promotions category, or sweep every currently discounted product in one run, including markdowns that never get a promotions-menu category.
• Full product detail on demand. Rich description, department and category, country of origin, health star rating, ingredients, allergens, dietary statement, storage instructions, the nutrition panel, and sibling variants.
• Ratings and reviews. Aggregate rating, star distribution and a capped list of customer reviews per product.
• Built for schedules. Incremental mode returns only new and changed products on recurring runs, and resume continues one interrupted run without re-billing what it already collected.

Use Cases

• Price and specials monitoring: track price, was price and offer labels across a shopping list or a whole department, and catch markdowns the promotions menu never lists.
• Grocery comparison and deal sites: publish weekly specials roundups using savings amount, unit price and multibuy details.
• Nutrition and dietary research: collect ingredients, allergens, health star rating and dietary statements at scale.
• Review and sentiment analysis: gather star ratings and review text per product for brand or category studies.
• Catalog and compliance auditing: filter or flag alcohol and tobacco listings using the built-in restricted-item flags.

Data You Get

Sample shape: values are illustrative placeholders, not from a live record.

Field	Example
stockcode	"100000"
name / brand	"Full Cream Milk 2L" / "Example Brand"
price / wasPrice	3.1 / 3.9
savingsAmount / savingsPercent	0.8 / 21
promoLabel	"Prices Dropped"
cupString / packageSize	"$1.55 / 1L" / "2L"
isOnSpecial	true
isInStock / isAvailable	true / true
ageRestricted / isTobacco	false / false
inStorePrice / inStoreIsOnSpecial	3.5 / true
departments / departmentNames	["dairy-eggs-fridge"] / ["Dairy, Eggs & Fridge"]
department / category / subCategory	"Dairy, Eggs & Fridge" / "Milk" / "Full Cream Milk"
healthStarRating	"4.5"
ingredients	"Full cream milk."
allergenContains / allergenMayContain	"Milk" / "May contain traces of soy"
dietaryStatement	"Vegetarian"
nutrition	{ "servingsPerPack": "8", "servingSize": "250mL" }
rating / reviewCount	4.6 / 54
ratingDistribution	{ "5": 96, "4": 20, "3": 7, "2": 3, "1": 2 }
variants	sibling flavours/sizes: stockcode, name, price, URL
url	product page on woolworths.com.au

Detail-enriched products also carry richDescription, fullDescription, importantInformation, storageInstructions, countryOfOrigin, barcode, multibuy and memberPrice offer details, an images gallery, and, when reviews are enabled, reviews with each review's rating, text, author display name and date.

How to Use

1. Pick a mode: search (keywords, plus an optional specials category) or url (paste product, category, specials or search links, or bare product codes).
2. Fill in the fields for that mode, then set the filters that apply to both, such as price range, minimum rating or specials only.
3. Turn on Fetch product details and Fetch customer reviews if you need nutrition, ingredients or reviews, then set Max products to control run size and cost.
4. Click Start, then download the dataset as JSON, CSV or Excel, or read it through the API.

Search a keyword in a price range:

{
  "mode": "search",
  "queries": ["milk"],
  "minPrice": 1,
  "maxPrice": 6,
  "fetchDetails": true,
  "maxItems": 20
}

Every currently discounted product, biggest savings first:

{
  "mode": "search",
  "specialsCategory": "all-specials-complete",
  "sortBy": "savings",
  "maxItems": 200
}

Paste product and category links, with reviews:

{
  "mode": "url",
  "urls": [
    "https://www.woolworths.com.au/shop/productdetails/32731",
    "https://www.woolworths.com.au/shop/browse/fruit-veg"
  ],
  "fetchReviews": true,
  "maxReviewsPerProduct": 10
}

Daily monitoring of a search, changes only:

{
  "mode": "search",
  "queries": ["tim tam"],
  "incrementalMode": true,
  "stateKey": "tim-tam-watch"
}

Run it from your code

Python:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/woolworths-au-scraper").call(run_input={"mode": "search", "queries": ["milk"]})
for product in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(product["name"], product["price"])

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/woolworths-au-scraper').call({ mode: 'search', queries: ['milk'] });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Or connect it to Make, Zapier, n8n, Google Sheets or webhooks from the Integrations tab.

Choosing a specials category

The promotions menu (half-price, buy-more-save-more, and so on) is a curated selection, not an index of every markdown, so a genuine discount can sit in none of its categories. Pick all-specials-complete to sweep every department for products the store currently flags as reduced, including offers the promotions menu never lists. It deliberately excludes Everyday Low Price, Lower Shelf Price and Bundles, since those are regular low shelf prices rather than offers, and it returns considerably more than the promotions menu does, so set Max products to bound the run.

Resume and recurring updates

• Resume from a previous run (resumeFromRunId) continues one interrupted run: paste its run or dataset ID and the actor skips every product already collected there, so you do not pay twice.
• Incremental mode (incrementalMode) is for scheduled runs over the same search or category. Each product is classified NEW, UPDATED (with changedFields naming what moved, such as price or specials), REAPPEARED, or EXPIRED (only after a run that scanned the whole scope, and only with emitExpired). UNCHANGED rows are suppressed and not billed unless emitUnchanged is on. stateKey names or deliberately shares a monitoring campaign's stored baseline.

Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape, the Apify dataset is never changed.

What gets written to the connector: a condensed, human-readable summary of each product, not the full JSON. Notion gets one page per product; other connectors get a best-effort write. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify, Settings, Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. If the picker is empty, you have not authorized a connector yet.
3. For Notion, also set notionParentPageUrl to the page where items should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

Input Parameters

Parameter	Type	Default	Description
mode	string	search	search (keywords and filters) or url (paste links / product codes).
queries	array	(none)	Search keywords (search mode). Each keyword is searched separately.
specialsCategory	string	""	Browse a whole specials category (search mode), or leave blank to skip.
urls	array	(none)	Product, category, specials or product-group URLs, search URLs, or bare product codes (url mode).
sortBy	string	relevance	relevance, price_asc, price_desc, name, or savings.
minRating	string	0	Keep products rated at least this many stars: 0, 3, 4, or 5. Requires fetchDetails.
specialsOnly	boolean	false	Keep only products currently on special.
excludeSpecialsCategories	array	(none)	Drop products in these specials categories instead of collecting and paying to enrich them.
excludeCategories	array	(none)	Departments to skip entirely, so they are never collected or charged.
includeMarketplace	boolean	false	Also include third-party Everyday Market seller products.
minPrice	integer	(none)	Keep products priced at or above this amount, in AUD.
maxPrice	integer	(none)	Keep products priced at or below this amount, in AUD.
fetchDetails	boolean	true	Collect full product detail plus aggregate rating.
fetchReviews	boolean	false	Also collect customer reviews.
maxReviewsPerProduct	integer	20	Cap on reviews collected per product (0 = all available).
maxItems	integer	20	Maximum number of products to return across the run (0 = unlimited).
maxPages	integer	(none)	Optional cap on result pages walked per keyword, category or URL. Leave empty to walk every page.
resumeFromRunId	string	(none)	ID of a previous run or dataset of this actor; already-collected products are skipped.
incrementalMode	boolean	false	Return only new, updated and reappeared products on scheduled runs.
stateKey	string	(none)	Name or share an incremental-mode monitoring campaign's stored state.
emitUnchanged	boolean	false	Also return (and bill) products with no change since the last run.
emitExpired	boolean	false	Also return (and bill) products from the baseline that are no longer found.
proxy	object	Apify Proxy	Connection settings.
mcpConnectors	array	(none)	Optional: send a summary of each product to apps you authorized under Integrations.
notionParentPageUrl	string	(none)	Notion connector only: page under which product pages are created.
maxNotifyListings	integer	50	Cap on items written to each connector per run.

Output Example

Sample shape: values are illustrative placeholders, not from a live record.

{
  "stockcode": "100000",
  "name": "Full Cream Milk 2L",
  "displayName": "Full Cream Milk 2L",
  "title": "Full Cream Milk 2L",
  "brand": "Example Brand",
  "url": "https://www.woolworths.com.au/shop/productdetails/100000/full-cream-milk",
  "price": 3.1,
  "wasPrice": 3.9,
  "savingsAmount": 0.8,
  "savingsPercent": 21,
  "isOnSpecial": true,
  "isHalfPrice": false,
  "isEdrSpecial": false,
  "promoLabel": "Prices Dropped",
  "savingsLabel": "Save $0.80",
  "promotionType": "Special",
  "cupPrice": 1.55,
  "cupMeasure": "1L",
  "cupString": "$1.55 / 1L",
  "packageSize": "2L",
  "unit": "Each",
  "currency": "AUD",
  "barcode": "9300000000000",
  "gtinFormat": 13,
  "isAvailable": true,
  "isInStock": true,
  "isNew": false,
  "isOnlineOnly": false,
  "ageRestricted": false,
  "isTobacco": false,
  "inStorePrice": 3.5,
  "inStoreWasPrice": 3.9,
  "inStoreSavingsAmount": 0.4,
  "inStoreSavingsPercent": 10,
  "inStoreIsOnSpecial": true,
  "inStoreCupPrice": 1.75,
  "inStoreCupString": "$1.75 / 1L",
  "image": "https://www.woolworths.com.au/wowproductimages/large/100000.jpg",
  "thumbnailImage": "https://www.woolworths.com.au/wowproductimages/small/100000.jpg",
  "departments": ["dairy-eggs-fridge", "lunch-box"],
  "departmentIds": ["1_C2FCE2B", "1_9E92C35"],
  "departmentNames": ["Dairy, Eggs & Fridge", "Lunch Box"],
  "richDescription": "A fresh Australian full cream milk, rich and creamy.",
  "department": "Dairy, Eggs & Fridge",
  "category": "Milk",
  "subCategory": "Full Cream Milk",
  "countryOfOrigin": "Made in Australia",
  "healthStarRating": "4.5",
  "ingredients": "Full cream milk.",
  "allergenContains": "Milk",
  "dietaryStatement": "Vegetarian",
  "storageInstructions": "Keep refrigerated below 4C.",
  "nutrition": { "servingsPerPack": "8", "servingSize": "250mL" },
  "rating": 4.6,
  "ratingCount": 128,
  "reviewCount": 54,
  "ratingDistribution": { "5": 96, "4": 20, "3": 7, "2": 3, "1": 2 },
  "reviews": [
    {
      "rating": 5.0,
      "body": "Fresh and creamy, our family buys it every week.",
      "author": "sampleShopper",
      "date": "2025-02-14T06:01:00.000Z",
      "syndicatedFrom": "woolworths"
    }
  ],
  "reviewsCollected": 1,
  "searchMode": "search"
}

Plan Requirement

The default proxy setting works out of the box, and the actor keeps trying alternate connections when one is refused. For large category walks, a full specials sweep, or frequent scheduled runs, the residential proxy group gives more headroom; pick it under Connection.

FAQ

How much does it cost?

You pay per product returned in the dataset, plus a one-time detail-enrichment charge for each product where detail and/or review extraction actually ran, and a small run-start charge. The Pricing tab shows the current rates. Use Max products to cap the cost of any run.

Is it legal to scrape Woolworths?

This actor collects only publicly available product information from the Woolworths website. You are responsible for how you use it: follow Woolworths' terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Prices and specials change constantly and are correct only at scrape time.

Can I get only new or changed products on a schedule?

Yes. Schedule the actor from the Schedules tab and turn on Incremental mode. Each run then returns only new, updated and reappeared products, and unchanged ones are not billed unless you turn on Emit unchanged.

What is the difference between Resume and Incremental mode?

They solve different problems. Resume continues ONE specific interrupted run: paste its run or dataset ID and already-collected products are skipped once. Incremental mode is for running the same search or category again and again, for example daily, and remembers its own baseline between runs so a recurring run returns only what changed. Use Resume to finish a run that stopped partway; use Incremental mode for ongoing monitoring.

Why did my run fail instead of returning an empty dataset?

A run fails only when no connection could be established at all before scraping started, or when a Resume from a previous run ID could not be read. A search or category that genuinely matches nothing, because your filters excluded every result or the keyword had no matches, still completes successfully with an empty (or filtered) dataset and a warning in the run log explaining why, rather than showing as failed.

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push a summary of your results into Notion, Linear or Airtable.

🔗 Want more grocery data?

Pair this actor with these related scrapers from the same team:

🥦 Coles AU Scraper Scrape Coles.com.au grocery products and customer reviews. Search by keyword, browse...	🥦 ALDI AU Scraper Scrape ALDI Australia (aldi.com.au) products: name, brand, price, was-price, savings...
🍷 Carrefour Spain Scraper Scrape Carrefour Spain (carrefour.es) products. Search by keyword, browse a category, or...	🥦 Auchan France Scraper Scrape Auchan.fr products: grocery, drinks, household and general merchandise. Real price...
🥦 Instacart Scraper Scrape Instacart grocery catalogs with per-store prices. Run keywords across several...	🍷 Dan Murphy’s Scraper Scrape Dan Murphy’s products by category, keyword, or specials. Extract 45+ fields...

👉 Browse all abotapi scrapers

💬 Support & custom scrapers

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email abotapi@proton.me or message Telegram @abotapi.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.