Woolworths Australia Grocery Product & Reviews Scraper

Scrape woolworths.com.au grocery products and customer reviews at scale. Search by keyword with filters, browse a whole specials & offers category, or paste product / search / specials links (or bare product codes). Every product comes back as one flat record with price, was-price and discount, unit (cup) price, specials, pack size, availability, images, category, nutrition, allergens, ingredients, rating and - optionally - customer reviews.

What it does

• Three ways to start
  • Search - one or more keywords, with sort, minimum-rating, price-range and specials-only filters, across all result pages.
  • Specials & offers category - browse a whole Woolworths specials category (Half Price, Online Only Specials, Everyday Low Price, Seasonal Price, Buy More Save More, Lower Shelf Price, Bundles, or all specials at once).
  • URL - paste product pages (/shop/productdetails/<code>), search pages (/shop/search/products?searchTerm=...), specials listing pages (/shop/browse/specials/half-price), or bare numeric product codes.
• Was-price & discount - on every discounted product you get the strike-through was-price, the savings amount and percentage, and the offer label (e.g. "Half Price", "Buy More Save More"), alongside the current price and unit (cup) price.
• Full product detail - collect each product's rich description, barcode (EAN/GTIN), department / category, country of origin, health-star rating, ingredients, allergens, dietary statement, storage instructions, the nutrition panel, images and sibling variants.
• Ratings & reviews - the aggregate rating (average score, rating count, review count and the 5-star-to-1-star distribution) plus customer reviews: star rating, review text, author display name and date.

Specials & offers

Pick a category under Specials & offers category (search mode) to walk a whole promotion, or paste a specials listing link in URL mode. The categories mirror Woolworths' own specials taxonomy:

Category value	Covers
all-specials	Every specials category, merged.
half-price	Half Price.
lower-shelf-price	Lower Shelf Price.
online-only-specials	Online Only Specials.
everyday-low-price	Everyday Low Price.
seasonal-price	Seasonal Price.
buy-more-save-more	Buy More Save More (multibuy).
bundles	Bundles.

Each product on a specials listing carries its was-price, savings and offer label; multibuy offers also carry the buy-more quantity and price.

Ratings & reviews: what you get

Woolworths shows an aggregate rating (average score, rating count, review count and the 5-star-to-1-star distribution) and a customer review list on product pages. This actor captures both:

• The aggregate rating and star distribution are collected during detail enrichment (fetchDetails), so every enriched product carries rating, ratingCount, reviewCount and ratingDistribution when it has ratings.
• The review list is collected when fetchReviews is on, up to your maxReviewsPerProduct cap. Each review carries star rating, text, author display name and date.

Note: many grocery lines carry few or no reviews. When a product has no ratings, the rating fields are omitted (not guessed) and reviews comes back empty. Products with reviews return them in full.

Input

Field	Type	Description
mode	select	search (keyword + filters) or url (paste links / product codes).
queries	string[]	Search keywords (search mode). Each keyword is searched separately.
specialsCategory	select	Browse a whole specials category: half-price, lower-shelf-price, online-only-specials, everyday-low-price, seasonal-price, buy-more-save-more, bundles, or all-specials. Leave blank to skip.
sortBy	select	relevance, price_asc, price_desc, name, savings.
minRating	select	Keep products rated at least 3, 4 or 5 stars (requires details).
specialsOnly	boolean	Keep only products currently on special / half price.
minPrice / maxPrice	integer	Keep products within an AUD price range.
urls	string[]	Product / search URLs, or bare product codes (url mode).
fetchDetails	boolean	Collect full product detail + aggregate rating. Default true.
fetchReviews	boolean	Also collect customer reviews. Default false.
maxReviewsPerProduct	integer	Cap reviews per product (0 = all). Default 20.
maxItems	integer	Primary limit: max products for the whole run (0 = unlimited). Default 20.
maxPages	integer	Safety cap on result pages walked per keyword/URL (36 products/page). Only bounds runs where maxItems is 0. Default 100.
proxy	object	Proxy configuration (Australian residential recommended).

Example input

{
  "mode": "search",
  "queries": ["milk"],
  "sortBy": "relevance",
  "specialsOnly": false,
  "minPrice": 1,
  "maxPrice": 20,
  "fetchDetails": true,
  "fetchReviews": true,
  "maxReviewsPerProduct": 20,
  "maxItems": 20,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AU" }
}

Example input - specials category

{
  "mode": "search",
  "specialsCategory": "half-price",
  "sortBy": "savings",
  "fetchDetails": true,
  "maxItems": 50,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AU" }
}

Output

One record per product. Example (values below are illustrative):

{
  "stockcode": "100000",
  "name": "Example Full Cream Milk 2L",
  "displayName": "Example Full Cream Milk 2L",
  "title": "Example Full Cream Milk 2L",
  "brand": "ExampleBrand",
  "url": "https://www.woolworths.com.au/shop/productdetails/100000/example-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,
  "variety": "Full Cream",
  "offerId": "24000000",
  "isMarketProduct": false,
  "image": "https://cdn0.woolworths.media/content/wowproductimages/large/100000.jpg",
  "thumbnailImage": "https://cdn0.woolworths.media/content/wowproductimages/small/100000.jpg",
  "images": ["https://cdn0.woolworths.media/content/wowproductimages/large/100000.jpg"],
  "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"
}

Field reference

Field	Description
stockcode	Woolworths product code (the SKU).
name, displayName, title, brand, url	Product name, display name, fuller canonical title (includes pack size), brand, product page URL.
price, wasPrice, savingsAmount, savingsPercent, isOnSpecial, isHalfPrice, isEdrSpecial	Current price, strike-through was-price, savings amount + percentage, and specials flags (including Everyday Rewards member specials).
promoLabel, savingsLabel, promotionType, promotionInfo	Offer label (e.g. "Half Price"), savings tag (e.g. "Save $7.00"), promotion type and the human-readable promotion sentence. Present on discounted products.
multibuy, memberPrice	Buy-more-save-more offer (quantity, price, cupString) and Everyday Rewards member price when applicable.
cupPrice, cupMeasure, cupString, packageSize, unit, currency	Unit (cup) price, pack size and currency (AUD).
barcode, gtinFormat	EAN/GTIN barcode and its GTIN format code.
isAvailable, isInStock, isNew, isOnlineOnly, productLimit, isMarketProduct, vendor, variety, offerId	Availability, new/online-only flags, purchase limit, market-seller info, variety and the offer id.
image, thumbnailImage, images	Primary image, thumbnail and the image list.
richDescription, department, category, subCategory, countryOfOrigin	Description, category path and origin (with details).
healthStarRating, ingredients, allergenContains, allergenMayContain, dietaryStatement, storageInstructions, nutrition	Grocery labelling and nutrition (with details).
variants	Sibling products (flavours / sizes) with code, name, price and URL.
rating, ratingCount, reviewCount, ratingDistribution	Aggregate rating and the 5★→1★ split (with details, when the product has ratings).
reviews, reviewsCollected	Collected reviews and their count (present when reviews are enabled).

Whenever a value is not published for a product, the field is omitted or null rather than guessed.

Proxy

Woolworths serves results to Australian residential connections, so the actor uses an Australian residential exit by default. Apify Proxy is recommended for reliable results.

Notes

• Prices, specials, ratings and stock are captured as shown on the storefront at scrape time.
• Filters (minRating, minPrice, maxPrice, specialsOnly) are applied to each product's own values, so exact numeric ranges work independently of the on-site filters.