# 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:** 4 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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(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 '{ "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": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,getdataforme/coles-review-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 ` 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/69t1IfOsmk8RamqJv/builds/Rkicg4luTmeFGvqkD/openapi.json