Coles Scraper: Prices, Specials, Down Down & Unit Prices

For retail price analysts, grocery brands and comparison services that need current Coles prices tied to an identifiable Australian store.

About US$0.0016 per product, including optional barcode, ingredients and nutrition. A 20-product check costs about US$0.032, plus the small Actor start fee. Product prices are in AUD. No login.

Search milk, coffee or Tim Tam, read a category or specials page, or provide product links and IDs. Every delivered product row names its price store. Repeated products at the same store are delivered and charged once.

What you get

Missing fields are null; was prices and promotion dates are never guessed. Displayed comparable units take precedence over inconsistent structured unit fields.

Field	Meaning
retailer, country, currency	Coles, AU and AUD
storeId, storeName	The verified Coles online price store
location	Requested postcode, or null for an explicit/default store
productId	Coles product identifier, returned as a string
sku	A separate SKU only if supplied by the source
gtin	Source barcode, normally available with product details
title, brand, size	Product name, brand and pack size
price	Current price at the confirmed store
regularPrice	The source's was price; zero sentinels become null
onSale	Whether the current source record indicates a price promotion
promoText, promoType	Offer wording and the source promotion classification
promoStart, promoEnd	Explicit source promotion dates, otherwise null
memberPrice, memberProgram	Public member pricing when supplied, otherwise null
unitPrice, unitOfMeasure	Comparable price and its quantity/measure, such as 100g
inStock, stockLevel	Source availability flag and available quantity when supplied
rating, reviewCount	Source review information, otherwise null
category	Readable Coles category path
url, imageUrl	Product link and primary image
scrapedAt	Observation timestamp in UTC

Extras preserve onlineHeirs, rawPricing, comparable-price text, multi-buys, availability type, purchase limits and aisles. Details add ingredients, allergens, nutrition, origin and description.

Overview shows prices, promotions, availability and store. The Deals view shows promotion fields. Use dealsOnly for a dataset containing only promotional products.

Choose a price store

Provide locations as four-digit Australian postcodes, including leading zeroes. Coles resolves a postcode into one or more localities. This Actor uses the first matching locality returned by Coles and selects the nearest trading Coles supermarket that has a collection point. The result identifies the selected suburb, distance and store postcode separately from your requested postcode.

In the 28 October 2026 test, postcode 2000 selected Coles Pyrmont, store 728, and 3000 selected Coles Collingwood, store 7842. Store postcodes can differ from the requested postcode. This does not establish delivery service for a street address.

For repeat monitoring, use storeIds once you have chosen the exact store. Store 313 is Coles Karratha. Empty locations and storeIds use the site's default online price store, which is resolved and identified in the output.

Before accepting a product response, the Actor checks Coles' returned store identifier against the selected store. A mismatched response becomes a free note. It is never relabelled as the requested store's price.

Start in three steps

1. Open the input form and enter a search term, postcode and maximum product count.
2. Run the Actor and inspect the Overview and run summary.
3. Export JSON for complete nested detail, or CSV for a spreadsheet. Save the same input as a task for repeat checks.

The prefill delivered 20 milk prices near postcode 2000 in 33 seconds. All three products in a Tim Tam detail check were enriched. Times vary with source responses and retries.

Search prices near one postcode

{
  "searchTerms": ["milk"],
  "locations": ["2000"],
  "maxItemsPerSearch": 20,
  "maxItems": 20,
  "includeDetails": false
}

Compare an exact store and enrich products

{
  "searchTerms": ["tim tam"],
  "storeIds": ["313"],
  "maxItemsPerSearch": 10,
  "maxItems": 10,
  "includeDetails": true
}

Read categories and half-price offers

{
  "startUrls": [
    "https://www.coles.com.au/browse/pantry",
    "https://www.coles.com.au/on-special?filter_Special=halfprice"
  ],
  "locations": ["3000"],
  "maxItemsPerSearch": 20,
  "maxItems": 40
}

Combine plain URL strings and numeric productIds in one run. Canonical redirects, including apostrophes in brand names, are followed.

Input reference

Input	Purpose
searchTerms	Array of search terms; milk is used when no source is provided
startUrls	Optional public Coles product, category, search or specials links
productIds	Optional numeric Coles product IDs
locations	Postcodes used to select online stores
storeIds	Explicit Coles supermarket IDs; can combine with postcodes
maxItemsPerSearch	New product rows per source per store; default 20, maximum 5,000
maxItems	Overall product/store row limit; default 20, maximum 10,000
dealsOnly	Keep price promotions; without other sources, reads specials
includeDetails	Fetch slower barcode, ingredients, nutrition and other extras at no extra price
proxyConfiguration	Optional custom proxy settings; empty uses automatic fallback

For ten products in each of three stores, set maxItemsPerSearch to 10 and overall maxItems to 30. Duplicates can reduce the total.

dealsOnly recognises source specials and multi-buy signals. An Every Day label by itself is not treated as a discount. A missing source price cannot become a paid product row. A search with no matches can complete with no product charge.

A real product example

This shortened row came from the 28 October 2026 detail test at Coles Karratha. Stock quantities can change between observations.

{
  "retailer": "Coles",
  "country": "AU",
  "currency": "AUD",
  "storeId": "313",
  "storeName": "Coles Karratha",
  "location": null,
  "productId": "329607",
  "gtin": "9310072000282",
  "title": "Tim Tam Chocolate Biscuits Original",
  "brand": "Arnott's",
  "size": "200g",
  "price": 4.5,
  "regularPrice": 6.42,
  "onSale": true,
  "promoText": "save $1.92",
  "promoType": "SPECIAL",
  "promoStart": null,
  "promoEnd": null,
  "memberPrice": null,
  "unitPrice": 2.25,
  "unitOfMeasure": "100g",
  "inStock": true,
  "stockLevel": 275,
  "detailsStatus": "complete"
}

Milk at Coles Pyrmont showed A$4.95 for 3L and A$1.65 per litre. The absent was price remained null.

Pricing and spending limits

One Product charge covers one distinct product at one store. Enabling details changes the amount of source work and the available fields, not the Product price. There is no separate detail, retry, failure or automatic dataset-item charge.

Job	Product price before plan discounts
20 product/store rows	US$0.032
100 product/store rows	US$0.16
1,000 product/store rows	US$1.60
20 products at three stores	US$0.096

The platform start fee is US$0.00005 per GB, with a minimum of one start unit. Bronze receives 5% off the Product price, Silver 10%, and Gold and higher tiers 20%. Platform compute, storage and the automatic Apify proxy path are included in the Actor price.

Set a maximum total charge in Apify for a firm budget. The Actor checks room for the next Product before fetching more product work, saves a row before charging it, and stops cleanly at the limit. Free note rows explain invalid inputs or refused sources. A repeated product at another store is a separate useful price observation and is charged once for that store.

Monitor prices every day

Create a saved task with a fixed store ID, stable product IDs or a category link. Add a daily Apify schedule at your preferred local time. Keep the store and product identifiers with each export, and retain scrapedAt so changes can be ordered correctly.

For promotions, schedule a specials task. Key observations by productId, storeId and scrapedAt. This Actor returns current snapshots, not historical backfill. Webhooks can move completed data to a database, spreadsheet, n8n or Make. Compare equivalent pack sizes and unit measures before calculating changes.

API use

Start a bounded run with a token from your own Apify account:

curl -X POST \
  'https://api.apify.com/v2/acts/vant47~coles-scraper/runs?memory=512&maxTotalChargeUsd=0.10' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"searchTerms":["milk"],"locations":["2000"],"maxItems":20}'

Poll the run ID, then read its dataset. SUMMARY is in its key-value store. Use asynchronous runs for larger jobs.

Python example:

import os
import time
import requests

base = "https://api.apify.com/v2"
headers = {"Authorization": "Bearer " + os.environ["APIFY_TOKEN"]}
response = requests.post(
    base + "/acts/vant47~coles-scraper/runs",
    params={"memory": 512, "maxTotalChargeUsd": 0.10},
    headers=headers,
    json={"searchTerms": ["milk"], "locations": ["2000"], "maxItems": 20},
    timeout=60,
)
response.raise_for_status()
run = response.json()["data"]
while run["status"] in ("READY", "RUNNING"):
    time.sleep(2)
    response = requests.get(base + "/actor-runs/" + run["id"], headers=headers, timeout=60)
    response.raise_for_status()
    run = response.json()["data"]
items = requests.get(
    base + "/datasets/" + run["defaultDatasetId"] + "/items",
    headers=headers,
    timeout=60,
).json()

JavaScript can use the same endpoints with fetch:

const headers = {
  Authorization: `Bearer ${process.env.APIFY_TOKEN}`,
  'Content-Type': 'application/json',
};
const response = await fetch(
  'https://api.apify.com/v2/acts/vant47~coles-scraper/runs?maxTotalChargeUsd=0.10',
  { method: 'POST', headers, body: JSON.stringify({
      searchTerms: ['coffee'], storeIds: ['313'], maxItems: 20,
  }) },
);
if (!response.ok) throw new Error(`Apify returned ${response.status}`);
const { data: run } = await response.json();
console.log(run.id);

Use with AI agents (MCP)

Connect your assistant to https://mcp.apify.com with your Apify account. Ask it to use vant47/coles-scraper, provide a small maxItems, and inspect the returned store IDs before making a comparison.

A useful request is: "Get Coles milk prices near postcode 2000. Return 20 products with current price, unit price and stock, and tell me which store supplied the prices. Keep the maximum charge at US$0.10."

Add includeDetails: true for enrichment. Preserve nulls and the run summary. No outside AI key is required.

Reliability and data limits

Requests are serial and paced, honour Retry-After and use fresh retry sessions. Datacenter proxy comes first, then Australian residential after refusals. Custom settings override this.

The dataset is the durable delivery ledger. Reboots recover saved rows and acknowledged charges before new work. Page candidates are saved before delivery; replayed acknowledgements do not create another Product charge.

Enrichment uses small batches of public product GraphQL requests. Prices and stock are store-scoped. Split inputs exceeding 1,000 source/location combinations.

Public client configuration is cached for one hour and public store-selection metadata for six hours. Product prices, promotions and stock are fetched fresh for the run. A changed site build can refresh configuration automatically. Cached metadata does not permit an unconfirmed store price to pass.

The source often omits promotion dates, public member prices and ratings. These fields were null in the initial sample where Coles did not provide them. Personalised Flybuys offers and account-specific prices are not retrieved. Public offer text is preserved where supplied; no member benefit is inferred from an ordinary special.

stockLevel is the source's available quantity, which can differ from stock physically on a shelf. Some listing types provide only availability and no quantity. Variable-weight products retain the displayed current price and comparable unit information; the final basket charge can depend on purchased weight.

If one source is refused, completed products remain in the dataset and a free note identifies the affected input. Check SUMMARY.status and freeFailures before treating an export as complete. Removed products, empty searches and input mistakes do not produce paid product rows.

FAQ

Can I compare several stores? Yes. Supply multiple postcodes or store IDs and increase the overall maxItems enough to cover them. Each row identifies its actual store.

Does the postcode have to equal the store postcode? No. A postcode selects a nearby online store through Coles' locality and store directory. Both values are preserved so you can audit the selection.

Are ingredients and barcodes extra? No. Turn on includeDetails for slower enrichment at the same Product price. Product links can already contain rich detail without an additional request.

Can I use it without a Coles account? Yes. It reads signed-out public product information. It does not sign in or solve verification challenges.

This is an independent Coles price data tool. Review the source's website terms for your intended use.