# Shopify Reviews Scraper (`mighty_monk/shopify-reviews-scraper`) Actor Pull customer reviews from Shopify product pages for competitor VOC research and ad creative mining. Supports Judge.me, Loox, Stamped, Yotpo, Shopify Product Reviews, and Okendo when detectable. - **URL**: https://apify.com/mighty\_monk/shopify-reviews-scraper.md - **Developed by:** [Harsh](https://apify.com/mighty_monk) (community) - **Categories:** E-commerce, AI - **Stats:** 8 total users, 7 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 review scrapeds 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ### What does Shopify Reviews Scraper do? **Shopify Reviews Scraper** pulls **customer reviews** from public Shopify product pages for competitor **voice-of-customer (VOC)** research and **ad creative mining**. Point it at one or more product URLs and get structured ratings, titles, bodies, authors, dates, and verified flags — plus product summaries. Built with **TypeScript** and **Crawlee CheerioCrawler**. When a common review widget is detected, the Actor prefers public JSON/widget endpoints (with HTML/DOM fallbacks): | Widget | Source value | | ------ | ------------ | | Judge.me | `judgeme` | | Loox | `loox` | | Stamped | `stamped` | | Yotpo | `yotpo` | | Shopify Product Reviews (SPR) | `shopify_spr` | | Okendo | `okendo` | | Schema.org / generic DOM | `schema_org` / `generic_dom` | ### Why use it? - **Ad copy mining** — harvest real 5-star phrases and objections for DTC creatives - **Competitor VOC** — compare rating distributions and review volume across stores - **Product research** — export clean review text for NLP / sentiment pipelines - **Batch product URLs** — concurrency, rate limiting, retries, and Apify Proxy ### How to use 1. Open the Actor in Apify Console and click **Try for free** 2. Paste one or more Shopify product URLs, e.g. `https://example-store.com/products/some-product` 3. Set **Max reviews per product**, optional **min/max rating**, and enable **Apify Proxy** 4. Click **Start** — download JSON/CSV/Excel from the dataset, or `REVIEWS.csv` / `SUMMARY.md` from key-value storage ### Input | Field | Type | Default | Description | | ----------------------- | -------- | ------- | ------------------------------------------------ | | `productUrls` | string[] | — | Shopify `/products/{handle}` URLs (required) | | `maxReviewsPerProduct` | integer | `100` | Cap reviews collected per product | | `minRating` | integer | `1` | Minimum star rating (1–5) | | `maxRating` | integer | `5` | Maximum star rating (1–5) | | `maxConcurrency` | integer | `3` | Parallel requests | | `maxRequestRetries` | integer | `3` | HTTP retries | | `requestDelayMs` | integer | `500` | Used to derive requests/minute rate limit | | `proxyConfiguration` | object | Proxy on| Apify Proxy settings | Example: ```json { "productUrls": [ "https://example-store.com/products/some-product" ], "maxReviewsPerProduct": 100, "maxConcurrency": 3, "maxRequestRetries": 3, "requestDelayMs": 500, "proxyConfiguration": { "useApifyProxy": true }, "minRating": 1, "maxRating": 5 } ```` ### Output The dataset contains **review** rows and **product** summary rows (`type` field). #### Review item | Field | Description | | --------------- | ------------------------------------ | | `productUrl` | Source product URL | | `productTitle` | Product title when detected | | `productId` | Shopify product id when detected | | `reviewId` | Stable id (deduped) | | `rating` | Stars 1–5 | | `title` | Review title | | `body` | Review text | | `author` | Reviewer display name | | `date` | ISO date when parseable | | `verified` | Verified buyer flag when available | | `source` | Widget / extraction method | #### Product summary | Field | Description | | ---------------- | ---------------------------------------- | | `productUrl` | Product URL | | `productTitle` | Title | | `productId` | Shopify id | | `handle` | Product handle | | `reviewSource` | Detected widget | | `averageRating` | From Schema.org or scraped sample | | `totalReviews` | Reported count when available | | `reviewsScraped` | Count stored for this product in the run | Example review: ```json { "type": "review", "productUrl": "https://example-store.com/products/some-product", "productTitle": "Some Product", "productId": "7234567890123", "reviewId": "judgeme-1001", "rating": 5, "title": "Worth every penny", "body": "Soft fabric, true to size, and arrived faster than expected.", "author": "Alex M.", "date": "2026-06-12T14:22:00.000Z", "verified": true, "source": "judgeme", "scrapedAt": "2026-07-13T12:00:00.000Z" } ``` #### Key-value exports | Key | Description | | ------------- | ------------------------------------------------ | | `REVIEWS.csv` | All review rows as CSV | | `SUMMARY.md` | Markdown run report (VOC samples + distributions)| | `OUTPUT` | JSON run totals | ### Features - Multi-widget detection (Judge.me, Loox, Stamped, Yotpo, SPR, Okendo) - Public widget JSON endpoints when available + HTML/DOM + Schema.org fallbacks - Pagination until `maxReviewsPerProduct` - Min/max rating filters - Deduplication by `reviewId` - Dataset: one review per row + product summary - Retries, rate limit, concurrency, Apify Proxy ### Pricing Pay-per-event: **$0.002 per review** dataset item (plus a small actor-start fee). Product summary rows are also dataset items. ### Limitations - Review apps that load **only** after heavy client-side JavaScript may return fewer reviews without a public widget API - Private authenticated review APIs are **not** used - Always respect store terms of service and robots policies; use moderate concurrency ### Development ```bash cd factory/shopify-reviews-scraper npm install npm test npm run build apify run -p ``` ### License Apache-2.0 # Actor input Schema ## `productUrls` (type: `array`): Shopify product page URLs (e.g. https://example-store.com/products/some-product). ## `maxReviewsPerProduct` (type: `integer`): Maximum number of reviews to collect for each product URL. ## `minRating` (type: `integer`): Only include reviews with star rating greater than or equal to this value (1–5). ## `maxRating` (type: `integer`): Only include reviews with star rating less than or equal to this value (1–5). ## `maxConcurrency` (type: `integer`): Maximum parallel HTTP requests. Keep moderate to reduce rate-limiting. ## `maxRequestRetries` (type: `integer`): How many times to retry a failed HTTP request before giving up. ## `requestDelayMs` (type: `integer`): Approximate delay between requests via maxRequestsPerMinute (60000 / delay). ## `proxyConfiguration` (type: `object`): Apify Proxy settings. Recommended for production runs against live stores. ## Actor input object example ```json { "productUrls": [ "https://example-store.com/products/some-product" ], "maxReviewsPerProduct": 100, "minRating": 1, "maxRating": 5, "maxConcurrency": 3, "maxRequestRetries": 3, "requestDelayMs": 500, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `reviewsCsv` (type: `string`): No description ## `summaryMd` (type: `string`): No description ## `output` (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 = { "productUrls": [ "https://example-store.com/products/some-product" ] }; // Run the Actor and wait for it to finish const run = await client.actor("mighty_monk/shopify-reviews-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 = { "productUrls": ["https://example-store.com/products/some-product"] } # Run the Actor and wait for it to finish run = client.actor("mighty_monk/shopify-reviews-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 '{ "productUrls": [ "https://example-store.com/products/some-product" ] }' | apify call mighty_monk/shopify-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mighty_monk/shopify-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Shopify Reviews Scraper", "description": "Pull customer reviews from Shopify product pages for competitor VOC research and ad creative mining. Supports Judge.me, Loox, Stamped, Yotpo, Shopify Product Reviews, and Okendo when detectable.", "version": "1.0", "x-build-id": "RALnF62S2eg3WKFxb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mighty_monk~shopify-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mighty_monk-shopify-reviews-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/mighty_monk~shopify-reviews-scraper/runs": { "post": { "operationId": "runs-sync-mighty_monk-shopify-reviews-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/mighty_monk~shopify-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-mighty_monk-shopify-reviews-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": [ "productUrls" ], "properties": { "productUrls": { "title": "Product URLs", "type": "array", "description": "Shopify product page URLs (e.g. https://example-store.com/products/some-product).", "default": [], "items": { "type": "string" } }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of reviews to collect for each product URL.", "default": 100 }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only include reviews with star rating greater than or equal to this value (1–5).", "default": 1 }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only include reviews with star rating less than or equal to this value (1–5).", "default": 5 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum parallel HTTP requests. Keep moderate to reduce rate-limiting.", "default": 3 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a failed HTTP request before giving up.", "default": 3 }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Approximate delay between requests via maxRequestsPerMinute (60000 / delay).", "default": 500 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Recommended for production runs against live stores.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```