# 🚀 Coles Scraper · 5,000 Free Products/Month (`omkar-cloud/coles-scraper`) Actor

Coles Scraper gets you Coles data ⚡ fast, 🎯 100% accurate and 🔍 ridiculously detailed — products, prices, specials & stock from any search, category or brand. 💰 $1 per 1,000 products, no start fee. Scrape your first 5,000 products free every month 🚀

- **URL**: https://apify.com/omkar-cloud/coles-scraper.md
- **Developed by:** [Omkar Cloud](https://apify.com/omkar-cloud) (community)
- **Categories:** E-commerce, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Coles Scraper

Coles Scraper by Omkar Cloud gets you ⚡ fast, 🎯 accurate, 🔍 detailed Coles data.

Products, prices, specials and stock from any Coles search, category, brand or specials page — so you can track grocery prices, watch a competitor's range, or build your own catalogue, and successfully complete your project.

**$1 per 1,000 products.** And with Apify's free plan you get $5 of credit every month, so your first **5,000 products each month are free**.

This is an excellent Actor made by Omkar Cloud, which is Rated Excellent — [4.7 based on 30 reviews on Trustpilot](https://www.trustpilot.com/review/omkar.cloud).

👉 [**Try Coles Scraper free**](https://apify.com/omkar-cloud/coles-scraper) — your first 5,000 products are Free.

### What can I get

- 🔍 **Search results** — any keyword, with brand, dietary, allergen & special filters
- 🗂️ **Whole categories & brands** — every product in a category, subcategory or brand
- 🏷️ **Specials** — all specials, half price, multi-buy or online only
- 🧾 **Full details** — barcode (GTIN), ingredients, allergens, nutrition, images, country of origin
- 🏬 **Per-store data** — prices, stock and aisle of the Coles store you choose

### Why Coles Scraper

Most other Coles scrapers fail you in one of four ways:

- 🗄️ **Inaccurate, cached, stale data** — last week's specials are useless
- 🧩 **Low-detail data** — a name and a price, never the full picture
- 💸 **Pay more to get the same data** — up to $10 per 1,000 products elsewhere
- 🪦 **Works today, breaks next month** — nobody maintains it

Coles Scraper gets you fresh, detailed data, is priced honestly, and actively maintained.

### What data you get

| Data | Fields |
|---|---|
| **Product** | `id`, `name`, `brand`, `size`, `description`, `link`, `image` |
| **Price** | `price`, `was_price`, `save_amount`, `save_percent`, `currency`, `unit_price`, `unit_price_label` |
| **Specials** | `is_on_special`, `special_type`, `price_description`, `offer_description`, `is_online_only_special`, `multi_buy_min_quantity`, `multi_buy_price_each`, `multi_buy_total_price` |
| **Stock** | `is_available`, `availability_type`, `available_quantity`, `retail_limit`, `promotional_limit`, `store_id` |
| **Category** | `department`, `category`, `subcategory` (each with its ID), `category_paths` |
| **In store** | `aisle`, `aisle_side`, `shelf` — when Coles shows them for the store |
| **Full details** (optional) | `gtin`, `long_description`, `images`, `ingredients`, `allergens`, `dietary_claims`, `country_of_origin`, `storage_instructions`, `warnings`, `variation_count`, `variation_varieties`, `variation_sizes` |
| **Nutrition** (optional) | `serving_size`, `energy_kj_per_100g`, `protein_g_per_100g`, `fat_total_g_per_100g`, `carbohydrate_g_per_100g`, `sugars_g_per_100g`, `sodium_mg_per_100g` + the full per-100g and per-serving panels |

### Example: A Full Coles Product

```json
{
  "query": "tim tam",
  "id": 329607,
  "name": "Tim Tam Chocolate Biscuits Original",
  "brand": "Arnott's",
  "size": "200g",
  "link": "https://www.coles.com.au/product/arnott-s-tim-tam-chocolate-biscuits-original-200g-329607",
  "gtin": "9310072000282",
  "image": "https://cdn.productimages.coles.com.au/productimages/3/329607.jpg",
  "images": [
    "https://shop.coles.com.au/wcsstore/Coles-CAS/images/3/2/9/329607.jpg",
    "https://shop.coles.com.au/wcsstore/Coles-CAS/images/3/2/9/329607_L.jpg",
    "https://shop.coles.com.au/wcsstore/Coles-CAS/images/3/2/9/329607_B.jpg"
  ],
  "is_available": true,
  "available_quantity": 519,
  "currency": "AUD",
  "price": 6,
  "was_price": null,
  "unit_price": 3,
  "unit_price_label": "$3.00/ 100g",
  "is_on_special": false,
  "price_description": null,
  "department": "Chips, Chocolates & Snacks",
  "category": "Biscuits & Cookies",
  "subcategory": "Chocolate Biscuits",
  "retail_limit": 20,
  "variation_count": 4,
  "country_of_origin": "Australia",
  "country_of_origin_statement": "Made in Australia",
  "ingredients": "Milk Chocolate (38%) [Emulsifiers (Lecithin (Soy), 476), Sugar, Milk Solids, Cocoa Butter, Cocoa Mass, Vegetable Oil, Flavour], Wheat Flour, Sugar, Vegetable Oil [Vegetable Oil, Emulsifier (Lecithin (Soy))], Antioxidant (307b (Soy)), Golden Syrup, Colours (Caramel III, Beet Red, Carmines, Annatto Extracts), Wheat Starch, Cocoa Powder, Salt, Baking Powder, Emulsifier (Lecithin (Soy)), Flavour.",
  "allergens": "Contains Gluten, Wheat\nMay Contain Egg, Peanut, Sesame",
  "storage_instructions": "To maintain freshness, store in a cool, dry place in an airtight, light proof container.",
  "serving_size": "100g",
  "servings_per_package": 2,
  "energy_kj_per_100g": 2190,
  "protein_g_per_100g": 4.6,
  "fat_total_g_per_100g": 26.8,
  "fat_saturated_g_per_100g": 15,
  "carbohydrate_g_per_100g": 65.1,
  "sugars_g_per_100g": 46,
  "sodium_mg_per_100g": 158,
  "store_id": "584",
  "last_updated": "2026-10-05T10:56:06Z"
}
```

*Trimmed for readability.* Every row is flat — each value is its own column, so CSV and Excel exports need no clean-up.

### Get Started with 5,000 Free Products

1. [Hit **Try for Free Button**](https://apify.com/omkar-cloud/coles-scraper) — the input is pre-filled with the "tim tam" and "cadbury dairy milk" search examples.
2. Enjoy your data 😎.

### Input examples

**Search by keyword, half-price specials only**

```json
{
    "searchQueries": ["tim tam", "cadbury dairy milk"],
    "specialType": "half_price",
    "maxResultsPerInput": 100
}
```

**A whole category and a whole brand, cheapest first**

```json
{
    "categories": ["dairy-eggs-fridge/milk"],
    "brands": ["Cadbury"],
    "sortBy": "price_low_to_high",
    "maxResultsPerInput": 500
}
```

**This week's half-price specials at another store**

```json
{
    "specials": "half_price",
    "store": "4166",
    "maxResultsPerInput": 1000
}
```

**Coles URLs with full details (barcode, ingredients, nutrition)**

```json
{
    "startUrls": [
        "https://www.coles.com.au/product/arnott's-tim-tam-chocolate-biscuits-original-200g-329607",
        "https://www.coles.com.au/browse/dairy-eggs-fridge/milk",
        "https://www.coles.com.au/on-special/pantry"
    ],
    "includeDetails": true,
    "maxResultsPerInput": 50
}
```

| Input | What it does |
|---|---|
| `searchQueries` | Keywords to search, each searched separately |
| `categories` | Category slug paths, IDs or coles.com.au/browse URLs |
| `brands` | Brand names, IDs or coles.com.au/brands URLs — scrapes the whole brand |
| `specials` | Scrape the specials feed: `all`, `half_price`, `multi_buy` or `online_only` |
| `startUrls` | Product, browse, on-special, search or brand page URLs |
| `specialType`, `filterBrands`, `dietary`, `allergens`, `sortBy` | Filters and sort order applied to every listing |
| `store` | Coles store ID or store URL (default `584`) |
| `maxResultsPerInput` | Cap per keyword, category, brand, specials feed or URL (default 100) |
| `includeDetails` | Also scrape every product in full (default off) |

### Pricing

High value, Low price.

| What | Price | What you get |
|---|---|---|
| **Standard products** | **$1 per 1,000** | id, name, brand, size, price, was-price, unit price, specials, multi-buy offers, stock, categories, purchase limits, image and link |
| **Detailed products** | $3 per 1,000 | Everything above + barcode (GTIN), long description, image gallery, ingredients, allergens, nutrition panel, dietary claims, country of origin, storage instructions, other varieties and sizes |

No start fee — you pay only for the rows you get. A detailed product is the standard $0.001 plus a $0.002 details add-on. Products that show up in several of your inputs are billed only once per run.

**Cost examples**

| Run | Products | Cost |
|---|---|---|
| "tim tam" search | 12 | $0.012 |
| The whole Milk category | 174 | $0.17 |
| Every Cadbury product, with full details | 162 | $0.49 |
| 5,000 products on special | 5,000 | $5.00 |

Control your spend with **Max Products per Input**: 1,000 products ≈ $1.

💡 Apify's free plan includes $5 of credit every month — **5,000 free products, every month**.

👉 [**Scrape your first 5,000 products free**](https://apify.com/omkar-cloud/coles-scraper)

### Run It from Code

Grab your API token from [Integrations Settings here](https://console.apify.com/settings/integrations) and replace `<YOUR_API_TOKEN>` below.

**Python** (`pip install apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("omkar-cloud/coles-scraper").call(run_input={
    "searchQueries": ["tim tam"],
    "maxResultsPerInput": 20,
})
for product in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(product["name"], product["price"], product["unit_price_label"])
```

**Node.js** (`npm install apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('omkar-cloud/coles-scraper').call({
    specials: 'half_price',
    maxResultsPerInput: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### FAQs

#### Which store are the prices and stock for?

Coles prices, stock and aisle locations are per store. By default you get store `584` (Coles Burwood East, VIC). Put another store ID or a coles.com.au store URL in **Coles Store** to get that store's data. Every row carries its `store_id`.

#### How many products can one search or category return?

Coles serves at most 104 pages of 48 products per listing, so a single search, category, brand or specials feed returns up to about 5,000 products (4,992). To go beyond that, split the job — scrape subcategories instead of a whole department, or run the same category with different sort orders or brand filters.

#### Will I be charged twice for the same product?

No. A product that appears in several of your inputs, or as a sponsored placement and again as a regular result, is scraped and billed once per run.

#### What does "Scrape Full Product Details" add?

Barcode (GTIN), long description, image gallery, ingredients, allergens, the nutrition panel, dietary claims, country of origin, storage and usage instructions, and the other varieties and sizes of the product. It adds $0.002 per product. If the full details of a product can't be read, you keep the standard row and pay only the standard rate.

#### Is the aisle always filled in?

No. `aisle`, `aisle_side` and `shelf` are only present when Coles shows an in-store location for the product at the selected store; otherwise they are empty.

#### Can I export to CSV or Excel?

Yes. Every row is flat, so the dataset exports to JSON, CSV, Excel or XML with one column per value.

#### Is this an official Coles product?

No. Coles Scraper is an independent tool and is not affiliated with or endorsed by Coles Group.

### Popular Actors by Omkar Cloud

- [**Amazon Scraper**](https://apify.com/omkar-cloud/amazon-scraper) — Amazon products, prices, ratings & full details
- [**AliExpress Product Scraper**](https://apify.com/omkar-cloud/aliexpress-product-scraper) — live product details, SKU variants, stock & shipping
- [**Etsy Scraper**](https://apify.com/omkar-cloud/etsy-scraper) — Etsy products: prices, discounts, shops & variations
- [**Website Email Contact Scraper**](https://apify.com/omkar-cloud/website-email-contact-scraper) — emails, phones & socials from any website

### 💬 Have Questions? We Have Answers.

[![Message Us on WhatsApp](https://raw.githubusercontent.com/omkarcloud/assets/master/images/whatsapp-us.png)](https://api.whatsapp.com/send?phone=918178804274\&text=I%20need%20help%20with%20using%20the%20Coles%20Scraper%20Actor.)
[![Ask Us on Email](https://raw.githubusercontent.com/omkarcloud/assets/master/images/ask-on-email.png)](mailto:happy.to.help@omkar.cloud?subject=Help%20with%20Coles%20Scraper%20Actor\&body=I%20need%20help%20with%20using%20the%20Coles%20Scraper%20Actor.)
You are important to us — just message us and we will solve your problem ✅ within 1 working day. 🩷 Pinky Promise 🤙!

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search on Coles — each is searched separately. Rows carry a `query` field so you can tell keywords apart. Leave empty to scrape only categories, brands, specials or URLs.

## `categories` (type: `array`):

Categories or subcategories to scrape. Each entry is a slug path (dairy-eggs-fridge/milk), a category ID (8881800) or a coles.com.au browse URL (https://www.coles.com.au/browse/dairy-eggs-fridge/milk). Rows carry a `category_input` field.

## `brands` (type: `array`):

Brands to scrape in full — every product of the brand. Each entry is a brand name (Cadbury), a brand ID (2146288555) or a coles.com.au brand URL (https://www.coles.com.au/brands/cadbury-2146288555). Rows carry a `brand_input` field.

## `specials` (type: `string`):

Also scrape the Coles specials listing of this type — every product currently on special. Rows carry a `specials_input` field.

## `startUrls` (type: `array`):

Product, browse, on-special, search and/or brand page URLs — you can mix them. Rows carry an `input_url` field. Product pages are always scraped with full details (billed at the detailed-product rate).

## `specialType` (type: `string`):

Only include products on this kind of special. Leave on Any product to include products that are not on special.

## `filterBrands` (type: `array`):

Only include products of these brands — brand names (case-insensitive) or brand IDs, up to 10. Example: Cadbury, Lindt. Not applied to the Brands input above, which already lists a single brand.

## `dietary` (type: `array`):

Only include products with these dietary labels, by name or ID, up to 10. Example: Vegan, Organic.

## `allergens` (type: `array`):

Only include products with these allergen labels, by name or ID, up to 10. Example: Gluten Free, Nut Free.

## `sortBy` (type: `string`):

Order of results. Default keeps each listing's own order: relevance for searches, best seller for categories and brands, recommended for specials.

## `store` (type: `string`):

Coles supermarket whose prices, stock and aisle locations you want: a store ID (4166) or a coles.com.au store URL (https://www.coles.com.au/find-stores/coles/nsw/marrickville-4166). Default: 584 (Coles Burwood East, VIC).

## `maxResultsPerInput` (type: `integer`):

Maximum number of products to scrape per keyword, category, brand, specials feed or listing URL. Use this to control your cost (1,000 products ≈ $1). Coles serves at most 4,992 products per listing (104 pages of 48). Ignored for product page URLs.

## `includeDetails` (type: `boolean`):

When enabled, every product is also scraped in full — barcode (GTIN), long description, image gallery, ingredients, allergens, nutrition panel, dietary claims, country of origin, storage and usage instructions, and other varieties and sizes. Still one dataset row per product, billed at the detailed-product rate (1,000 detailed products ≈ $3 vs $1 standard). Runs take longer because each product page is fetched individually.

## Actor input object example

```json
{
  "searchQueries": [
    "tim tam",
    "cadbury dairy milk"
  ],
  "categories": [
    "dairy-eggs-fridge/milk"
  ],
  "brands": [
    "Cadbury"
  ],
  "specials": "none",
  "startUrls": [
    "https://www.coles.com.au/product/arnott's-tim-tam-chocolate-biscuits-original-200g-329607",
    "https://www.coles.com.au/browse/dairy-eggs-fridge/milk"
  ],
  "specialType": "",
  "filterBrands": [
    "Cadbury",
    "Lindt"
  ],
  "dietary": [
    "Vegan",
    "Organic"
  ],
  "allergens": [
    "Gluten Free",
    "Nut Free"
  ],
  "sortBy": "",
  "store": "584",
  "maxResultsPerInput": 100,
  "includeDetails": false
}
```

# Actor output Schema

## `results` (type: `string`):

Every row with every field.

## `overview` (type: `string`):

Image, name, brand, size, price, was-price, unit price, special and stock of every product.

## `details` (type: `string`):

Barcode, ingredients, allergens, nutrition per 100g, country of origin and variations of detailed products.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "tim tam",
        "cadbury dairy milk"
    ],
    "maxResultsPerInput": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("omkar-cloud/coles-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": [
        "tim tam",
        "cadbury dairy milk",
    ],
    "maxResultsPerInput": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("omkar-cloud/coles-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "tim tam",
    "cadbury dairy milk"
  ],
  "maxResultsPerInput": 100
}' |
apify call omkar-cloud/coles-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,omkar-cloud/coles-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Ivsg3Xq4jDrdbkMaf/builds/7PEsdZcdVEluQV6Z3/openapi.json