Skip to main content
Scrape Woolworths (Australia) groceries

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

mode
string | null

'search' (default): products matching query. 'category': a category listing. 'specials': a specials page (Half Price unless category names another). 'product': one product with nutrition and ingredients. Defaults to 'product' when product is given and to 'category' when category is.

query
string | null

What to search for (mode=search), e.g. 'milk', 'tim tam', 'chicken breast'.

category
string | null

mode=category: a browse link (https://www.woolworths.com.au/shop/browse/dairy-eggs-fridge/milk), its path ('dairy-eggs-fridge/milk') or a category id ('1_6E4F4E4'). mode=specials: the specials page - 'half-price' (default), 'lower-shelf-price', 'everyday-low-price', 'seasonal-price', 'buy-more-save-more', 'online-only-specials' or a specials link.

product
string | null

mode=product: a stockcode ('888137') or a product link (https://www.woolworths.com.au/shop/productdetails/888137/woolworths-full-cream-milk).

sort
string
default:relevance

Listing order: relevance, price_asc, price_desc, unit_price_asc, unit_price_desc, name.

specials_only
boolean
default:false

mode=search: only products on special.

page
integer
default:1

1-based listing page to start from (36 products per page).

max_results
integer
default:36

Products to collect across pages, 1-360. Each page fetched is billed one unit.

proxy_country
string | null

Proxy country the request is sent from (ISO-2, e.g. 'AU', 'US'). Leave blank: Woolworths answers every country, so the load spreads over all exits.

Response

JSON with products (listings) or product. A search with no matches answers 200 with an empty products list; one Woolworths shows only to signed-in shoppers (tobacco) also carries warnings.