Skip to main content
Scrape Coles (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': the products on special. '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.coles.com.au/browse/dairy-eggs-fridge/milk) or its path ('dairy-eggs-fridge/milk').

product
string | null

mode=product: a Coles product id ('8150288') or a product link (https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288).

special
string | null

Products on special only: all, half-price, multibuy, online-only. mode=specials defaults to 'all'; with mode=search it filters the results.

sort
string
default:relevance

Listing order: relevance, price_asc, price_desc, unit_price_asc.

page
integer
default:1

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

max_results
integer
default:48

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

proxy_country
string | null

Proxy country the request is sent from: AU, NZ, US or CA (Coles serves only these). Leave blank to spread over all of them.

Response

JSON with products (listings) or product. A search with no matches answers 200 with an empty products list.