# Coles AU Scraper – Groceries, Prices & Reviews (`abotapi/coles-au-scraper`) Actor Scrape Coles.com.au grocery products and customer reviews. Search by keyword, browse categories, or use product/search URLs. Returns name, brand, price, was price, unit price, size, specials, availability, aisle/category, nutrition, allergens, ingredients, ratings, and reviews. - **URL**: https://apify.com/abotapi/coles-au-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.20 / 1,000 product results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Coles Australia Grocery Product & Reviews Scraper Scrape coles.com.au grocery products and customer reviews at scale. Search by keyword, browse a category, pull the On Special catalogue, or paste product / search links (or bare product ids). Every product comes back as one flat record with price, was-price and savings, unit (comparable) price, specials, size, availability, aisle/category, nutrition, allergens, ingredients, rating and - optionally - customer reviews. ### What it does - **Four ways to start** - **Search** - one or more keywords, with minimum-rating, price-range and specials filters, across all result pages. - **Specials** - browse Coles' own On Special catalogue by its real offer taxonomy: **All specials**, **Half price**, **Multi buy** or **Online only** (the `specialsCategory` field, search mode). Every product returned is on special and carries its was-price, saving amount/percent and promo label. - **Category** - browse a category by its Coles slug (e.g. `dairy-eggs-fridge`), across all its pages. - **URL** - paste product pages (`/product/-`), search pages (`/search/products?q=...`), category pages (`/browse/`), On Special pages (`/on-special`, `/on-special/`), or bare numeric product ids. - **Was-price & discounts** - on every discounted product the record carries the strike-through was-price, the saving amount and percent, the promo label (e.g. `1/2 Price`), the promotion type, and, for multi-buy offers, the multi-buy detail (e.g. buy 2 for $7). - **Full product detail** - collect each product's canonical title, long description, ingredients, allergens, dietary statement, storage instructions, dimensions, country of origin, GTIN, brand, category path, product variants, the nutrition panel and images. - **Ratings & reviews** - the aggregate rating (average score, review count and the 5-star-to-1-star distribution) plus customer reviews: star rating, title, review text, author display name, date, verified-purchase flag and helpful-vote count. - **Send results into your apps** - optional Notion / Linear / Airtable / Apify export via MCP connectors, without changing the dataset. ### Ratings & reviews: what you get Coles shows an **aggregate rating** and a **customer review list** on product pages. This actor captures both: - The **aggregate rating** and star distribution are collected during enrichment (`fetchDetails`), so every enriched product that has ratings carries `rating`, `ratingCount`, `reviewCount` and `ratingDistribution`. - The **review list** is collected when `fetchReviews` is on, walked across review pages up to your `maxReviewsPerProduct` cap. Each review carries star rating, title, text, author display name, ISO date, verified-purchase flag and helpful-vote count. > **Note:** most Coles grocery lines carry no reviews at all - reviews cluster on health, beauty, vitamins, pet and baby lines. When a product has no ratings, the rating and reviews fields are **omitted (not guessed)**. Products with reviews return them in full. ### Specials & discounts Select a `specialsCategory` in search mode to walk Coles' own **On Special** catalogue with the same forward pagination and `maxItems` cap as a keyword search: | Value | What it returns | |-------|-----------------| | `allspecials` | The whole On Special listing. | | `halfprice` | Products at half price (50% off). | | `multibuy` | Multi-buy offers (e.g. buy 2 for $7). | | `onlineonly` | Online-only specials. | In URL mode, paste an On Special link instead - `https://www.coles.com.au/on-special` for everything, or `https://www.coles.com.au/on-special/` (e.g. `/on-special/bakery`) to scope it to one department. Every product returned from a specials source is on special, so each record carries `wasPrice`, `savingsAmount`, `savingsPercent`, `savingsLabel`, `promoLabel`, `promotionType` and `specialType`; multi-buy offers also carry `offerDescription` and a structured `multibuyPromotion`. The `specialsOnly` toggle is a separate client-side filter that keeps only on-special products from any search, category or specials source. ### Ordering Coles serves search and category pages in **relevance order**. The optional `sortBy` (`price_asc`, `price_desc`, `name`) is applied over the products the run collects, so it orders the gathered result set rather than re-querying the store. Leave it on `relevance` to keep the storefront's own order. ### Input | Field | Type | Description | |-------|------|-------------| | `mode` | select | `search` (keyword + filters), `category` (browse a category slug), or `url` (paste links / product ids). | | `queries` | string[] | Search keywords (search mode). Each keyword is searched separately. | | `specialsCategory` | select | Browse Coles' On Special catalogue (search mode): `allspecials`, `halfprice`, `multibuy` or `onlineonly`. Leave empty to skip. | | `categories` | string[] | Category slugs (category mode), e.g. `dairy-eggs-fridge`. | | `sortBy` | select | `relevance`, `price_asc`, `price_desc`, `name` (applied over the collected products). | | `minRating` | select | Keep products rated at least `3`, `4` or `5` stars (requires enrichment). | | `specialsOnly` | boolean | Keep only products currently on special (any source). | | `minPrice` / `maxPrice` | integer | Keep products within an AUD price range. | | `urls` | string[] | Product / search / category URLs, or bare product ids (url mode). | | `fetchDetails` | boolean | Collect full product detail + aggregate rating. Default `true`. | | `fetchReviews` | boolean | Also collect customer reviews. Default `false`. | | `maxReviewsPerProduct` | integer | Cap reviews per product (`0` = all). Default `20`. | | `maxItems` | integer | Max products for the whole run (`0` = unlimited). Default `20`. | | `maxPages` | integer | Safety cap on result pages walked per keyword/category/URL. | | `proxy` | object | Proxy configuration (Australian residential recommended). | | `mcpConnectors` | array | Optional MCP connectors to export results into (Notion, Linear, Airtable, Apify). | | `notionParentPageUrl` | string | Notion connector only: page under which item pages are created. | | `maxNotifyListings` | integer | Cap on items exported to each connector per run. Does not affect the dataset. | #### Example input ```json { "mode": "search", "queries": ["milk"], "sortBy": "relevance", "specialsOnly": false, "minPrice": 1, "maxPrice": 20, "fetchDetails": true, "fetchReviews": true, "maxReviewsPerProduct": 20, "maxItems": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AU" } } ```` ### Send results into your apps (MCP connectors) Optionally pipe results into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it in the `mcpConnectors` field. Each connector receives a condensed, human-readable summary per product (title plus key fields), while the complete record always stays in the Apify dataset. For Notion, set `notionParentPageUrl` to the page the item pages should be created under. Supported connectors: Notion, Linear, Airtable, and Apify. Leave the field empty to skip; it never changes the dataset output. ### Output One record per product. Example (values below are illustrative): ```json { "productId": "100000", "name": "Example Full Cream Milk 2L", "title": "ExampleBrand Full Cream Milk 2L", "brand": "ExampleBrand", "description": "EXAMPLE FULL CREAM MILK 2L", "size": "2L", "url": "https://www.coles.com.au/product/example-full-cream-milk-2l-100000", "price": 3.0, "wasPrice": 6.0, "savingsAmount": 3.0, "savingsPercent": 50, "savingsLabel": "save $3.00", "promoLabel": "1/2 Price", "promotionType": "SPECIAL", "specialType": "PERCENT_OFF", "isOnSpecial": true, "comparablePrice": "$1.50 per 1L", "unitPrice": 1.5, "unitOfMeasure": "l", "unitMeasure": "1l", "currency": "AUD", "isAvailable": true, "availabilityType": "InStoreAndOnline", "availableQuantity": 500, "retailLimit": 20, "promotionalLimit": 12, "ageRestricted": false, "aisle": "Full Cream Milk", "category": "Milk", "subCategory": "Dairy, Eggs & Fridge", "department": "DAIRY", "productClass": "FULL CREAM", "variantCount": 3, "image": "https://cdn.productimages.coles.com.au/productimages/1/100000.jpg", "images": ["https://cdn.productimages.coles.com.au/productimages/1/100000.jpg"], "longDescription": "A fresh Australian full cream milk, rich and creamy.", "gtin": "9300000000000", "brandSlug": "examplebrand", "countryOfOrigin": "Australia", "countryOfOriginStatement": "Made in Australia from at least 99% Australian ingredients", "categoryPath": ["Milk", "Dairy, Eggs & Fridge", "Full Cream Milk"], "variants": [ { "productId": "100001", "name": "Example Full Cream Milk 1L", "brand": "ExampleBrand", "size": "1L", "url": "https://www.coles.com.au/product/example-full-cream-milk-1l-100001", "image": "https://cdn.productimages.coles.com.au/productimages/1/100001.jpg" } ], "ingredients": "Full cream milk.", "allergens": "Contains Milk", "dietary": "Source of Calcium", "storageInstructions": "Keep refrigerated. Store at or below 5°C.", "dimensions": "250.00 x 100.00 x 100.00 mm", "nutrition": { "servingSize": "250mL", "servingsPerPackage": "8.00", "breakdown": [] }, "rating": 4.6, "ratingCount": 128, "reviewCount": 128, "ratingDistribution": { "5": 96, "4": 20, "3": 7, "2": 3, "1": 2 }, "recommendedCount": 118, "reviews": [ { "reviewId": "1000000001", "rating": 5.0, "title": "Family favourite", "body": "Fresh and creamy, our family buys it every week.", "author": "sampleShopper", "date": "2025-02-14T06:01:00.000+00:00", "isRecommended": true, "helpfulCount": 4 } ], "reviewsCollected": 1, "searchMode": "search" } ``` #### Field reference | Field | Description | |-------|-------------| | `productId` | Coles product id. | | `name`, `title`, `brand`, `description`, `size`, `url` | Product name, fuller canonical title (brand + name + size), brand, short description, size, product page URL. | | `price`, `wasPrice`, `savingsAmount`, `savingsPercent`, `savingsLabel`, `isOnSpecial` | Current price, strike-through was-price, saving amount/percent, saving label and specials flag. | | `promoLabel`, `promotionType`, `specialType`, `offerDescription`, `multibuyPromotion` | Promo label (e.g. `1/2 Price`), promotion/special type, and, for multi-buy offers, the offer text and structured multi-buy detail (`quantity`, `price`, `unitPrice`, `description`). Present on discounted products. | | `comparablePrice`, `unitPrice`, `unitOfMeasure`, `unitMeasure`, `currency` | Comparable (unit) price string, numeric unit price, unit, the measure the unit price is quoted against (e.g. `100g`), and currency (AUD). | | `isAvailable`, `availabilityType`, `availableQuantity`, `retailLimit`, `promotionalLimit`, `ageRestricted` | Availability, purchase limits and age-restriction flag. | | `aisle`, `category`, `subCategory`, `department`, `productClass`, `categoryPath` | Category path (online aisle / category, internal department and product class), plus the breadcrumb path (with details). | | `variantCount`, `variants` | Number of sibling variations and, with details, the variant matrix (`productId`, `name`, `brand`, `size`, `url`, `image`). | | `image`, `images` | Primary image and the image list. | | `longDescription`, `gtin`, `brandSlug`, `countryOfOrigin`, `countryOfOriginStatement`, `lastUpdated` | Long description, GTIN, brand slug, country of origin (country name plus the full origin statement) and last-updated timestamp (with details). | | `ingredients`, `allergens`, `dietary`, `storageInstructions`, `dimensions`, `nutritionalClaims`, `nutrition`, `disclaimers` | Grocery labelling and nutrition (with details, when published). | | `rating`, `ratingCount`, `reviewCount`, `ratingDistribution`, `recommendedCount` | Aggregate rating and the 5★→1★ split (with enrichment, when the product has ratings). | | `reviews`, `reviewsCollected` | Collected reviews and their count (present when reviews are enabled). Each review: `reviewId`, `rating`, `title`, `body`, `author`, `date`, `verifiedPurchase`, `isRecommended`, `helpfulCount`, `syndicatedFrom`, `photos`. | Whenever a value is not published for a product, the field is omitted or `null` rather than guessed. ### Proxy Coles serves results to Australian residential connections, so the actor uses an **Australian residential** exit by default. Apify Proxy is recommended for reliable results. ### Notes - Prices, specials, ratings and stock are captured as shown on the storefront at scrape time. - Filters (`minRating`, `minPrice`, `maxPrice`, `specialsOnly`) are applied to each product's own values, so exact numeric ranges work independently of the on-site filters. - `verifiedPurchase` is included when the storefront exposes it for a review; on many reviews it is not published and the field is left out. # Actor input Schema ## `mode` (type: `string`): Choose 'search' for keywords + filters, 'category' to browse a category by its Coles slug, or 'url' to scrape specific Coles Australia product / search / category URLs (or bare product ids) you paste below. ## `queries` (type: `array`): One or more keywords to search, for example 'milk' or 'tim tam'. Each keyword is searched separately. ## `categories` (type: `array`): One or more Coles category slugs to browse, for example 'dairy-eggs-fridge' or 'pantry/chips-crackers-nuts'. Each is walked separately across its result pages. ## `sortBy` (type: `string`): How to order the collected products. Applied client-side over the products gathered in the run before they are returned. ## `minRating` (type: `string`): Optional. Only keep products whose average customer rating is at least this many stars. Requires enrichment (ratings are collected during 'Fetch product details' / 'Fetch customer reviews'). Products with no reviews are excluded when this is set. ## `specialsCategory` (type: `string`): Optional (search mode). Browse Coles' own On Special catalogue instead of / alongside your keywords, using Coles' real specials taxonomy. 'All specials' walks the whole On Special listing; 'Half price', 'Multi buy' and 'Online only' apply Coles' matching offer filter. Every product returned is on special and carries its was-price, saving amount/percent and promo label. Leave as 'Not selected' to skip. In URL mode, paste an On Special link (e.g. /on-special or /on-special/bakery) instead. ## `specialsOnly` (type: `boolean`): Optional. Keep only products currently on special (applies a was-price / offer filter over the products the run collects). Works with any search, category or specials source. ## `minPrice` (type: `integer`): Optional. Only keep products priced at or above this amount. ## `maxPrice` (type: `integer`): Optional. Only keep products priced at or below this amount. ## `urls` (type: `array`): Product, search, category or On Special URLs (or bare numeric product ids) to scrape, for example https://www.coles.com.au/search/products?q=milk , a category page under /browse/ , an On Special listing under /on-special (optionally /on-special/), or a product page under /product/. Multiple entries supported. ## `fetchDetails` (type: `boolean`): Collect each product's full detail (long description, ingredients, allergens, dietary statement, storage, dimensions, country of origin, GTIN, nutrition panel and images) plus its aggregate rating and star distribution. ## `fetchReviews` (type: `boolean`): Also collect customer reviews for each product (star rating, title, review text, author display name, date, verified-purchase flag and helpful-vote count), walked across review pages. Note: most Coles grocery products carry no reviews; those records leave the rating/reviews fields absent. ## `maxReviewsPerProduct` (type: `integer`): Cap on reviews collected per product when 'Fetch customer reviews' is on. Use 0 for all available reviews. ## `maxItems` (type: `integer`): Maximum number of products to return across the whole run. Use 0 for unlimited. ## `maxPages` (type: `integer`): Optional safety bound on result pages walked per keyword/category/URL. Leave empty to walk as deep as needed. This does NOT cap the number of products — the run stops at Max products. ## `proxy` (type: `object`): Apify Proxy is required for reliable results. The actor connects through an Australian residential exit by default. ## `mcpConnectors` (type: `array`): Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write/digest. Leave empty to skip; never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "queries": [ "milk" ], "categories": [ "dairy-eggs-fridge" ], "sortBy": "relevance", "minRating": "0", "specialsCategory": "", "specialsOnly": false, "urls": [ "https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288" ], "fetchDetails": true, "fetchReviews": false, "maxReviewsPerProduct": 20, "maxItems": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "milk" ], "categories": [ "dairy-eggs-fridge" ], "urls": [ "https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/coles-au-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["milk"], "categories": ["dairy-eggs-fridge"], "urls": ["https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288"], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AU", }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/coles-au-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "milk" ], "categories": [ "dairy-eggs-fridge" ], "urls": [ "https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }' | apify call abotapi/coles-au-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/coles-au-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Coles AU Scraper – Groceries, Prices & Reviews", "description": "Scrape Coles.com.au grocery products and customer reviews. Search by keyword, browse categories, or use product/search URLs. Returns name, brand, price, was price, unit price, size, specials, availability, aisle/category, nutrition, allergens, ingredients, ratings, and reviews.", "version": "1.0", "x-build-id": "NxYirIrxFIJi5QbUw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~coles-au-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-coles-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/abotapi~coles-au-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-coles-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/abotapi~coles-au-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-coles-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "category", "url" ], "type": "string", "description": "Choose 'search' for keywords + filters, 'category' to browse a category by its Coles slug, or 'url' to scrape specific Coles Australia product / search / category URLs (or bare product ids) you paste below.", "default": "search" }, "queries": { "title": "Search keywords", "type": "array", "description": "One or more keywords to search, for example 'milk' or 'tim tam'. Each keyword is searched separately.", "items": { "type": "string" } }, "categories": { "title": "Category slugs", "type": "array", "description": "One or more Coles category slugs to browse, for example 'dairy-eggs-fridge' or 'pantry/chips-crackers-nuts'. Each is walked separately across its result pages.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc", "name" ], "type": "string", "description": "How to order the collected products. Applied client-side over the products gathered in the run before they are returned.", "default": "relevance" }, "minRating": { "title": "Minimum average rating", "enum": [ "0", "3", "4", "5" ], "type": "string", "description": "Optional. Only keep products whose average customer rating is at least this many stars. Requires enrichment (ratings are collected during 'Fetch product details' / 'Fetch customer reviews'). Products with no reviews are excluded when this is set.", "default": "0" }, "specialsCategory": { "title": "Specials / offers category", "enum": [ "", "allspecials", "halfprice", "multibuy", "onlineonly" ], "type": "string", "description": "Optional (search mode). Browse Coles' own On Special catalogue instead of / alongside your keywords, using Coles' real specials taxonomy. 'All specials' walks the whole On Special listing; 'Half price', 'Multi buy' and 'Online only' apply Coles' matching offer filter. Every product returned is on special and carries its was-price, saving amount/percent and promo label. Leave as 'Not selected' to skip. In URL mode, paste an On Special link (e.g. /on-special or /on-special/bakery) instead.", "default": "" }, "specialsOnly": { "title": "Only products on special", "type": "boolean", "description": "Optional. Keep only products currently on special (applies a was-price / offer filter over the products the run collects). Works with any search, category or specials source.", "default": false }, "minPrice": { "title": "Minimum price (AUD)", "minimum": 0, "type": "integer", "description": "Optional. Only keep products priced at or above this amount." }, "maxPrice": { "title": "Maximum price (AUD)", "minimum": 0, "type": "integer", "description": "Optional. Only keep products priced at or below this amount." }, "urls": { "title": "Coles Australia URLs / product ids", "type": "array", "description": "Product, search, category or On Special URLs (or bare numeric product ids) to scrape, for example https://www.coles.com.au/search/products?q=milk , a category page under /browse/ , an On Special listing under /on-special (optionally /on-special/), or a product page under /product/. Multiple entries supported.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Collect each product's full detail (long description, ingredients, allergens, dietary statement, storage, dimensions, country of origin, GTIN, nutrition panel and images) plus its aggregate rating and star distribution.", "default": true }, "fetchReviews": { "title": "Fetch customer reviews", "type": "boolean", "description": "Also collect customer reviews for each product (star rating, title, review text, author display name, date, verified-purchase flag and helpful-vote count), walked across review pages. Note: most Coles grocery products carry no reviews; those records leave the rating/reviews fields absent.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "type": "integer", "description": "Cap on reviews collected per product when 'Fetch customer reviews' is on. Use 0 for all available reviews.", "default": 20 }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Maximum number of products to return across the whole run. Use 0 for unlimited.", "default": 20 }, "maxPages": { "title": "Max pages per keyword / category", "minimum": 0, "maximum": 20, "type": "integer", "description": "Optional safety bound on result pages walked per keyword/category/URL. Leave empty to walk as deep as needed. This does NOT cap the number of products — the run stops at Max products." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is required for reliable results. The actor connects through an Australian residential exit by default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write/digest. Leave empty to skip; never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```