Woolworths Australia price scraper — specials, unit price

Woolworths Australia prices by search term: shelf price, was-price, specials and unit price (per kg or litre), from the public product-search catalog. No login. $1 per 1,000 products.

Last updated: 2026-10-02 · Guide: https://alidaram99.github.io/api-alternatives/woolworths-api/

Uses Apify's Australian residential proxy by default, because Woolworths blocks datacenter IPs. Only public catalog data is collected.

Use cases

• Price monitoring: track your own or a competitor's shelf prices over time.
• Grocery inflation research: collect price/unit-price data across staple search terms on a schedule.
• Competitor pricing: compare specials, savings and unit pricing across product ranges.

Input

Field	Type	Description
searchTerms	array (required)	Search terms, e.g. ["milk", "bread"]. Each term is paginated independently.
categoryUrls	array	Reserved for future category-browsing support — not yet implemented, see Limits.
maxItemsPerSearch	integer	Stop after this many items per search term. Default 100.
sortBy	string	relevance | priceAsc | priceDesc | unitPriceAsc | name. Applied client-side — see FAQ.
includeUnavailable	boolean	Include out-of-stock/unavailable items. Default false.
proxyConfiguration	object	Standard Apify Proxy editor. Defaults to Apify Residential proxy in Australia — see FAQ "Why Residential proxy?" for why.

Example input:

{
  "searchTerms": ["milk", "bread", "eggs"],
  "maxItemsPerSearch": 100,
  "sortBy": "priceAsc",
  "includeUnavailable": false
}

(proxyConfiguration is omitted here deliberately — leaving it out uses the Residential-AU default, which is what you want in almost every case.)

Output

One row per product:

{
  "stockcode": "888140",
  "name": "Woolworths Full Cream Milk",
  "brand": "Woolworths",
  "description": "Woolworths Full Cream Milk 3L",
  "packageSize": "3L",
  "price": 4.95,
  "wasPrice": 4.95,
  "isOnSpecial": false,
  "savingsAmount": 0,
  "cupPrice": 1.65,
  "cupMeasure": "1L",
  "cupString": "$1.65 / 1L",
  "isAvailable": true,
  "isInStock": true,
  "unit": "Each",
  "imageUrl": "https://cdn1.woolworths.media/content/wowproductimages/medium/888140.jpg",
  "productUrl": "https://www.woolworths.com.au/shop/productdetails/888140/woolworths-full-cream-milk",
  "categories": [],
  "rating": 0,
  "reviewCount": 0,
  "searchTerm": "milk",
  "scrapedAt": "2026-10-02T00:14:46.726Z"
}

No customer data of any kind is collected — only public catalog/pricing fields.

How it compares

Option	What you get	Price	Notes
This Actor	Price, was-price, specials, unit price, stock flags, image and product URL	$1 per 1,000 products	Residential AU proxy by default; search terms only (no category URLs yet)
Other Woolworths Actors on Apify	Similar product data	Varies widely between Actors	Compare success rate, unit-price fields and proxy handling
Woolworths website	Same public data, by hand	Free	No export

Pricing

$0.001 per item ($1 per 1,000 products), pay-per-event. Proxy and compute costs are covered by the Actor's price, not added to your bill.

FAQ

Is there a Woolworths API for prices?

Woolworths has no public product API for this. This Actor collects the public product-search catalog by search term and returns clean JSON or CSV.

What price fields do I get?

Current price, was-price, special flag, savings amount and unit price (cupPrice, cupMeasure, cupString, e.g. "$1.70 / 1L"), plus name, brand, package size, stock flags, image and product URL.

Can I scrape a Woolworths category URL?

Not in this version. categoryUrls is accepted and has no effect. Use searchTerms.

Why does it use an Australian residential proxy?

This Actor's own original local testing (from an ordinary home internet connection) worked fine calling Woolworths directly, with no proxy at all. On Apify's own infrastructure, Woolworths returns HTTP 403 to Apify's datacenter IP ranges — and to direct, no-proxy requests from Apify — but works through Apify's Residential proxy in Australia, confirmed with a real live run. That's why the default changed to Residential AU rather than "no proxy": it's the one option actually confirmed to work on the platform this Actor runs on, not just on the machine it was built on. If you turn the default off, the Actor still switches to it automatically the first time it sees an HTTP 403 with no proxy in effect, and fails loudly (rather than returning nothing) if that automatic fallback isn't available to your account. See VERIFY.md §R1 for the live evidence, the proxy-cost measurement, and the citations on who pays for proxy bandwidth under this Actor's pricing model.

Do I pay extra for the proxy?

No. Under this Actor's pay-per-event pricing, platform costs (proxy bandwidth included) are paid out of the Actor's own revenue share. You pay only the per-product price.

How many products per page?

Up to 36, Woolworths' own limit. The Actor pages through results up to maxItemsPerSearch.

Why does sortBy say it is applied client-side?

Woolworths' own sort parameter had no effect over this interface (every value returned identical ordering), so the Actor sorts the results it collected.

What does it cost?

$0.001 per product ($1 per 1,000). No subscription.

Limits

• Category browsing is not implemented. /apis/ui/Browse/Category exists and is allowed by robots.txt, but a plain GET returns "CategoryId is required" — the endpoint expects a CategoryId/Url/FormatObject request shape that wasn't pinned down in this version. Use searchTerms instead.
• Up to 36 items per page (Woolworths' own hard limit; confirmed live — pageSize=48 returns "Page size should not be greater than the limit: 36").
• Only public catalog/pricing data — no customer accounts, no checkout, no personal data.
• Requires Apify Residential proxy (the default) to work reliably on Apify's own infrastructure — see FAQ "Why Residential proxy?". Residential proxy bandwidth is a real, measured cost on top of this Actor's $1/1,000 price — see VERIFY.md §R1 for the measured amount and for who actually bears that cost under this pricing model.

Verified on Apify

Verified live on Apify's own infrastructure on 2026-10-02: datacenter IPs get HTTP 403 from Woolworths, and the default residential AU proxy works. A 98-item run succeeded with 0 rejected items, and the nightly health check passes. Measured platform cost is about $0.025 per 1,000 items, proxy included, and is paid by the Actor's revenue share. Details are in VERIFY.md §R1.