Coles Scraper

Scrape Coles Australia (coles.com.au) groceries as clean JSON: search results, whole categories, the products on special (all, half price, multibuy, online only) or product pages. Every product comes with price, was-price, savings, unit price, the promotion (half price, special, multibuy), availability and stock count, purchase and promotional limits, image, categories and minimum shelf life; product pages add the description, ingredients, allergens, nutrition panel, storage, dimensions, country of origin, image gallery and variants. Prices are Coles' online prices in AUD.

Features

• Search mode - products matching each search term (queries); specialType keeps only products on that kind of special.
• Category mode - every product of each category (categories: browse link or path).
• Specials mode - the products on special (specialType: all, half price, multibuy or online only).
• Product mode - one product page per input (products: product link or id) with nutrition and ingredients.
• Up to 2000 products per listing - pages are followed automatically.
• Many inputs per run - search terms, categories or products in parallel.

Use cases

• Price monitoring - shelf prices, specials and unit prices across categories.
• Promotions research - every half price and multibuy deal.
• Stock tracking - available quantity and purchase limits.
• Nutrition and ingredient databases - nutrition panels and allergens.

Input

Field	Type	Default	Description
mode	string	search	search, category, specials or product.
queries	array	milk	Search terms (search mode).
categories	array	-	Browse links or paths (dairy-eggs-fridge/milk) (category mode).
products	array	-	Product links or ids (product mode).
maxResults	integer	48	Products per listing (1-2000).
sort	string	relevance	relevance, price_asc, price_desc, unit_price_asc.
specialType	string	none	none, all, half-price, multibuy, online-only: which specials to list, or a search filter.
proxyCountry	string	-	Optional exit-IP country: AU, NZ, US or CA.
concurrency	integer	3	Inputs processed at the same time (1-5).

Example input

{
  "mode": "specials",
  "specialType": "half-price",
  "maxResults": 300,
  "sort": "price_asc"
}

Output

One dataset item per product. A listing item (search, category, specials):

{
  "mode": "search",
  "input": "milk",
  "position": 1,
  "id": "8150288",
  "name": "Full Cream Milk",
  "brand": "Coles",
  "size": "3L",
  "url": "https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288",
  "barcode": null,
  "price": 4.95,
  "wasPrice": null,
  "currency": "AUD",
  "onSale": false,
  "savings": null,
  "promotion": null,
  "unitPrice": {
    "price": 1.65,
    "per": "1l",
    "text": "$1.65/ 1L"
  },
  "priceDescription": null,
  "inStock": true,
  "available": true,
  "availableQuantity": 2749,
  "purchaseLimit": 20,
  "promotionalLimit": 12,
  "onlineOnly": false,
  "sponsored": false,
  "image": "https://cdn.productimages.coles.com.au/productimages/8/8150288.jpg",
  "categories": [
    "Dairy, Eggs & Fridge",
    "Milk"
  ],
  "minimumShelfLife": "Life 7 days min"
}

A product-mode item adds the product page's details (lists shortened):

{
  "mode": "product",
  "input": "8150288",
  "id": "8150288",
  "name": "Full Cream Milk",
  "brand": "Coles",
  "size": "3L",
  "url": "https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288",
  "barcode": "9300601186945",
  "price": 4.95,
  "wasPrice": null,
  "currency": "AUD",
  "onSale": false,
  "savings": null,
  "promotion": null,
  "unitPrice": {
    "price": 1.65,
    "per": "1L",
    "text": "$1.65/ 1L"
  },
  "priceDescription": null,
  "inStock": true,
  "available": true,
  "availableQuantity": null,
  "purchaseLimit": 20,
  "promotionalLimit": 12,
  "onlineOnly": false,
  "sponsored": false,
  "image": "https://cdn.productimages.coles.com.au/productimages/8/8150288.jpg",
  "categories": [
    "Dairy, Eggs & Fridge",
    "Milk"
  ],
  "minimumShelfLife": "Life 7 days min",
  "description": "Coles is committed to bringing you high quality fresh milk from dairy farms across Australia",
  "ingredients": "Homogenised and Pasteurised Full Cream Milk.",
  "allergens": "Contains Milk",
  "dietary": "Source of Calcium",
  "storage": "Keep this way up,Keep refrigerated. Store at or below 5°C",
  "usage": null,
  "dimensions": "273.00 x 153.00 x 102.00 mm",
  "nutrition": [
    {
      "name": "Energy (kJ)",
      "perServing": "646 kJ",
      "per100": "258 kJ",
      "dailyIntake": "7% DI"
    },
    {
      "name": "Energy (Cal)",
      "perServing": "155 Cal",
      "per100": "61.8 Cal"
    }
  ],
  "servingSize": "250mL",
  "servingsPerPack": "12.00",
  "countryOfOrigin": "Australian",
  "countryOfOriginLabel": "Australian Milk",
  "australianIngredientsPercent": 100.0,
  "images": [
    "https://cdn.productimages.coles.com.au/productimages/8/8150288.jpg",
    "https://shop.coles.com.au/wcsstore/Coles-CAS/images/8/1/5/8150288.jpg"
  ],
  "variants": [
    {
      "id": "5593963",
      "name": "Reduced Fat Hi Lo Milk",
      "brand": "Coles",
      "size": "2L",
      "url": "https://www.coles.com.au/product/coles-reduced-fat-hi-lo-milk-2l-5593963",
      "barcode": null,
      "price": null,
      "wasPrice": null,
      "currency": "AUD",
      "onSale": false,
      "savings": null,
      "promotion": null,
      "unitPrice": null,
      "priceDescription": null,
      "inStock": false,
      "available": false,
      "availableQuantity": null,
      "purchaseLimit": null,
      "promotionalLimit": null,
      "onlineOnly": false,
      "sponsored": false,
      "image": "https://cdn.productimages.coles.com.au/productimages/5/5593963.jpg",
      "categories": [
        "Dairy, Eggs & Fridge",
        "Milk",
        "Skim & Low Fat Milk"
      ],
      "minimumShelfLife": null
    },
    {
      "id": "8083883",
      "name": "Lite Milk",
      "brand": "Coles",
      "size": "3L",
      "url": "https://www.coles.com.au/product/coles-lite-milk-3l-8083883",
      "barcode": null,
      "price": null,
      "wasPrice": null,
      "currency": "AUD",
      "onSale": false,
      "savings": null,
      "promotion": null,
      "unitPrice": null,
      "priceDescription": null,
      "inStock": false,
      "available": false,
      "availableQuantity": null,
      "purchaseLimit": null,
      "promotionalLimit": null,
      "onlineOnly": false,
      "sponsored": false,
      "image": "https://cdn.productimages.coles.com.au/productimages/8/8083883.jpg",
      "categories": [
        "Dairy, Eggs & Fridge",
        "Milk",
        "Skim & Low Fat Milk"
      ],
      "minimumShelfLife": null
    }
  ],
  "lastUpdated": "2026-10-12T18:36:12Z"
}

The key-value store also holds:

• LISTINGS - per search term, category or specials listing: total results, pages fetched and products collected.
• ERRORS - inputs that returned no products (no match, unknown product or category, blocked) with the reason. These are not billed.

Pricing

$0.90 per 1000 products. You pay only for products delivered; inputs without products are not charged.

Notes

• Coles shows 48 products per page; a listing returns at most maxResults products, sometimes a few less when pages repeat sponsored products.
• Coles serves only Australia, New Zealand, the US and Canada, so proxyCountry must be one of AU, NZ, US, CA (or empty).
• This actor is not affiliated with Coles.