# Coles Review Scraper (`getdataforme/coles-review-scraper`) Actor The Coles Review Scraper extracts detailed product reviews from Coles URLs, delivering structured JSON data with ratings, review text, and product details. Ideal for market research, sentiment analysis, and competitive insights. Supports proxy use for reliable scraping. - **URL**: https://apify.com/getdataforme/coles-review-scraper.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** E-commerce, Social media - **Stats:** 5 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $10.00 / 1,000 results 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/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 Review Scraper The Coles Review Scraper is an Apify Actor designed to extract detailed product review data from Coles product pages. By providing a list of product URLs, users can retrieve structured review information, including ratings, review text, product details, and more, in a clean JSON format. This Actor is perfect for market research, sentiment analysis, and competitive analysis. ### Input Parameters The Actor accepts the following input parameters in JSON format: | Parameter | Type | Description | |-----------|--------|-----------------------------------------------------------------------------| | `urls` | Array | A list of Coles product URLs to scrape reviews from (e.g., `["https://www.coles.com.au/product/tip-top-muffins-english-original-400g-332394"]`). | | `proxyConfiguration` | Object | Optional proxy settings (e.g., `{ "useApifyProxy": true }`). Defaults to using Apify proxy for reliable scraping. | Example input: ```json { "urls": ["https://www.coles.com.au/product/tip-top-muffins-english-original-400g-332394"], "proxyConfiguration": { "useApifyProxy": true } } ```` ### Features - **Comprehensive Review Extraction**: Retrieves detailed review data, including ratings, titles, review text, product details, and metadata like review date and country. - **Structured JSON Output**: Returns data in a clean, easy-to-use JSON format for seamless integration into your workflows. - **Proxy Support**: Leverages Apify's proxy capabilities to ensure reliable and uninterrupted scraping. - **Scalable and Efficient**: Handles multiple URLs in a single run, making it suitable for both small and large-scale scraping tasks. ### Example Output The Actor returns a JSON array containing review details for each product. Below is an example output: ```json [ { "Product_Id": "332394", "Review_Id": "1181882042", "Rating": 4, "Title": "smaller", "Body": "Getting smaller but still great for eggs", "Sentiment": null, "Section": "", "Higher_Topic": null, "Granular_Topic": null, "Source": "Bazaarvoice", "Full_Review": "smaller: Getting smaller but still great for eggs", "Review_Type": "Product Review", "Title_Trans": "smaller", "Body_Trans": "Getting smaller but still great for eggs", "Full_Review_Trans": "smaller: Getting smaller but still great for eggs", "Product_Name_Trans": "TIP TOP MUFFINS ORIGINAL ENGLISH 6 PACK", "Product_Segment": null, "Gender": "Male", "Product_Segment2": null, "Year_Quarter": "2025_Q1", "Sub_Brand": "", "Format": "", "Country": "Australia", "Date": "02-28-2025", "Product_Name": "TIP TOP MUFFINS ORIGINAL ENGLISH 6 PACK", "Brand": "Tip Top", "URL": "https://www.coles.com.au/product/tip-top-muffins-english-original-400g-332394", "Crawled_Date": "06-29-2025" } ] ``` ### Use Cases - **Market Research**: Analyze customer feedback on Coles products to understand consumer preferences and trends. - **Competitive Analysis**: Compare review ratings and sentiments across different brands or products sold on Coles. - **Product Development**: Identify common customer complaints or suggestions to improve product offerings. - **Sentiment Analysis**: Use review data to perform sentiment analysis and gauge customer satisfaction. ### Support For bug reports or custom needs, please contact us at or use our contact form at . Make sure to include a clear subject line in your message, such as "Coles Review Scraper Support." Thank you for using the Coles Review Scraper! # Actor input Schema ## `urls` (type: `array`): The URL of website you want to get the data from. ## `itemLimit` (type: `integer`): The maximum number of items to scrape from each page. ## Actor input object example ```json { "urls": [ "https://www.coles.com.au/product/tip-top-muffins-english-original-400g-332394" ], "itemLimit": 10 } ``` # 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 = { "urls": [ "https://www.coles.com.au/product/tip-top-muffins-english-original-400g-332394" ] }; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/coles-review-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 = { "urls": ["https://www.coles.com.au/product/tip-top-muffins-english-original-400g-332394"] } # Run the Actor and wait for it to finish run = client.actor("getdataforme/coles-review-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 '{ "urls": [ "https://www.coles.com.au/product/tip-top-muffins-english-original-400g-332394" ] }' | apify call getdataforme/coles-review-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/coles-review-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Coles Review Scraper", "description": "The Coles Review Scraper extracts detailed product reviews from Coles URLs, delivering structured JSON data with ratings, review text, and product details. Ideal for market research, sentiment analysis, and competitive insights. Supports proxy use for reliable scraping.", "version": "0.0", "x-build-id": "Rkicg4luTmeFGvqkD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~coles-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-coles-review-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/getdataforme~coles-review-scraper/runs": { "post": { "operationId": "runs-sync-getdataforme-coles-review-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/getdataforme~coles-review-scraper/run-sync": { "post": { "operationId": "run-sync-getdataforme-coles-review-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": [ "urls" ], "properties": { "urls": { "title": "URL of the page", "type": "array", "description": "The URL of website you want to get the data from.", "items": { "type": "string" } }, "itemLimit": { "title": "Item Limit", "type": "integer", "description": "The maximum number of items to scrape from each page.", "default": 10 } } }, "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 } } } } } } } } } } ```