# Amazon Reviews Scraper Pro (`crawlerbros/amazon-reviews-scraper-pro`) Actor Extract customer reviews from any Amazon product across 19+ domains with star-rating filtering and sort options. Same cookie-free, residential-proxy architecture as the base scraper. - **URL**: https://apify.com/crawlerbros/amazon-reviews-scraper-pro.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 16 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Amazon Reviews Scraper Pro Amazon Reviews Scraper Pro is the Pro tier of our Amazon reviews scraper. Same anti-bot resilience, cookie-free architecture, and field set as the base scraper — packaged separately for users who want a distinct deployment slot. Extract customer reviews from any Amazon product across **19+ Amazon domains** worldwide. Returns structured review data including text, star rating, helpful count, date, location, sentiment hint, images, variant, and reviewer profile (optional, GDPR-aware). This actor runs in **cookie-free public-data mode** and ships with a mandatory Apify residential proxy. There is nothing for you to log into or maintain — give it product URLs, get reviews back. ### Features - **Multi-product support**: Scrape reviews from many Amazon products in one run - **19 Amazon domains**: amazon.com, .co.uk, .de, .fr, .it, .es, .ca, .com.au, .co.jp, .in, .com.br, .com.mx, .nl, .sg, .ae, .sa, .pl, .se, .com.tr - **Smart filtering**: filter by star rating (1-5) - **Flexible sorting**: most helpful or most recent - **GDPR aware**: optional inclusion of reviewer name / profile / avatar - **Image extraction**: optional capture of reviewer-uploaded images - **Stealth + residential proxy**: Chromium with anti-detection scripts and sticky-session residential routing - **Built-in retries**: up to 3 fresh-session retries on transient blocks ### Output Schema Each review is returned with the following structure (omit-empty: any field that the source did not populate is dropped, never returned as `null`). ```json { "productAsin": "B09X7MPX8L", "ratingScore": 5, "reviewTitle": "Amazing product!", "reviewUrl": "https://www.amazon.com/gp/customer-reviews/R1234567890", "reviewReaction": "123 people found this helpful", "reviewedIn": "Reviewed in the United States on January 15, 2024", "reviewDescription": "This is the full review text...", "isVerified": true, "variant": "Size: Large, Color: Blue", "reviewImages": ["https://images-na.ssl-images-amazon.com/..."], "position": 1, "reviewId": "R1234567890", "helpfulCount": 123, "reviewDate": "2024-01-15T00:00:00", "reviewLocation": "United States", "sentimentHint": "positive", "wordCount": 150, "hasImages": true, "imageCount": 2, "scrapedAt": "2024-01-20T10:30:00Z", "sourceUrl": "https://www.amazon.com/dp/B09X7MPX8L" } ```` `reviewerName`, `reviewerProfile`, and `reviewerAvatar` are returned **only** when `includeGdprSensitive` is set to `true`. ### Input Configuration | Field | Type | Description | Default | | ---------------------- | ------- | ----------------------------------------------------- | ---------------- | | `productUrls` | array | Amazon product URLs (required) | - | | `proxyConfiguration` | object | Apify residential proxy (required) | RESIDENTIAL | | `maxReviews` | integer | Reviews per product (1–15, capped by inline render) | 15 | | `sortBy` | enum | `helpful` or `recent` | `helpful` | | `filterByStar` | enum | `""`, `"1"`, `"2"`, `"3"`, `"4"`, `"5"` | `""` (all) | | `includeImages` | boolean | Extract reviewer-uploaded images | `true` | | `includeGdprSensitive` | boolean | Include reviewer name / profile / avatar | `false` | | `country` | enum | Amazon domain (19 supported) | `amazon.com` | | `maxConcurrency` | integer | Concurrent pages (1-5) | `1` | | `requestTimeout` | integer | Per-page timeout in seconds (30–180) | `60` | | `retryCount` | integer | Fresh-session retries on blocks (1–10) | `3` | #### Example input ```json { "productUrls": [ "https://www.amazon.com/dp/B09X7MPX8L" ], "maxReviews": 15, "sortBy": "helpful", "filterByStar": "", "includeImages": true, "includeGdprSensitive": false, "country": "amazon.com", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` ### Cookie-Free Public-Data Mode This actor never logs in to Amazon and never carries authenticated session cookies. That choice keeps it simple to run, but it imposes hard limits that are dictated by Amazon — not by the scraper itself. **What you get:** - Up to **~8–13 "top reviews" per ASIN** — Amazon's inline review block on the `/dp/{ASIN}` product page - All public review fields (text, rating, date, location, helpful count, images, variant) **What is not supported:** - **Pagination beyond the inline block.** Amazon now redirects every anonymous `/product-reviews/{ASIN}` request to `/ap/signin`, regardless of country, TLS fingerprint, or warmup pattern (verified across 6 mitigation strategies in May 2026). Reviews are therefore extracted from the inline block on the product detail page, which renders 8–13 reviews and has no "next page". - **Star-rating filter at fetch time.** The `filterByStar` input still works, but is applied client-side to the inline block — expect 0–5 reviews per star. - **The verified-purchase filter** (`reviewerType=avp_only_reviews`) requires an authenticated session and is therefore not exposed as an input. The `isVerified` flag IS still populated per review. **Why a residential proxy is required:** Amazon aggressively blocks anonymous datacenter IPs within seconds. The `proxyConfiguration` field is therefore `required` in the input schema and the actor exits cleanly with a typed status message if missing. ### Supported Amazon Domains | Domain | Country | | ------------- | -------------- | | amazon.com | United States | | amazon.co.uk | United Kingdom | | amazon.de | Germany | | amazon.fr | France | | amazon.it | Italy | | amazon.es | Spain | | amazon.ca | Canada | | amazon.com.au | Australia | | amazon.co.jp | Japan | | amazon.in | India | | amazon.com.br | Brazil | | amazon.com.mx | Mexico | | amazon.nl | Netherlands | | amazon.sg | Singapore | | amazon.ae | UAE | | amazon.sa | Saudi Arabia | | amazon.pl | Poland | | amazon.se | Sweden | | amazon.com.tr | Turkey | ### GDPR Compliance When `includeGdprSensitive=false` (the default) the scraper omits: - Reviewer names - Reviewer profile links - Reviewer avatars Set it to `true` only if you have a lawful basis to process that data. ### FAQs **Can I get more than ~13 reviews per product?** No. In cookie-free public-data mode, anonymous `/product-reviews/` pages redirect to a sign-in wall, so reviews come from the inline block on the `/dp/` product page — Amazon renders **~8-13 "top reviews" per ASIN** there, with no "next page". Higher caps require authenticated sessions, which this actor intentionally does not support. **Why is my run returning 0 reviews?** The most common cause is that `proxyConfiguration` was omitted or set to something other than `RESIDENTIAL`. Anonymous datacenter IPs get redirected to a sign-in wall almost immediately. Check the run log for a `Residential proxy required` status message. **Can I scrape reviews translated into other languages?** Yes — pick the corresponding domain in `country` (e.g. `amazon.de` for German). Reviews are returned in the language of the chosen storefront. **Do you support reviews from a specific verified-purchase filter?** No. That filter requires an authenticated Amazon session. The `isVerified` field on each review is still populated, so you can filter the output yourself in your downstream pipeline. **How is the data deduplicated?** Reviews are deduplicated by `reviewId` across products in a single run (there is no per-page pagination in cookie-free mode, so pagination duplicates cannot occur). **Are you respecting Amazon's robots.txt?** Yes. This actor only fetches `/dp/{ASIN}` product pages, which Amazon's robots.txt does not disallow for `User-agent: *`. There is no `Crawl-delay` directive on amazon.com; the actor still paces requests via `requestTimeout` and a default 2 s inter-product delay. ### Limitations - **~8-13 reviews per ASIN** in cookie-free mode (Amazon's inline `/dp/` block ceiling). Anonymous `/product-reviews/` pages redirect to sign-in. - Verified-purchase pre-filtering is unavailable; `isVerified` is still set per review. - Run-to-run review counts can vary by +/- 10% as Amazon shuffles the order of "Most helpful" reviews. - A residential Apify proxy is required; running without one exits cleanly with a typed status message and produces no records. ### Integration ```bash ## Get results via API curl "https://api.apify.com/v2/datasets/{datasetId}/items?token={apiToken}" ``` Output formats supported by Apify: JSON, CSV, Excel, RSS, HTML table. # Actor input Schema ## `productUrls` (type: `array`): List of Amazon product URLs to scrape reviews from. Supports /dp/, /gp/product/, and /product/ URL formats across 19+ Amazon domains. ## `country` (type: `string`): Amazon country domain to scrape from. URLs from a different domain are honored automatically. ## `maxReviews` (type: `integer`): Maximum number of reviews to scrape per product (1-15). Cookie-free mode is capped by Amazon's inline /dp/ review block, which renders ~8-13 top reviews per ASIN with no pagination. ## `sortBy` (type: `string`): How to sort the reviews ## `filterByStar` (type: `string`): Filter reviews by specific star rating (1-5). Leave empty for all ratings. ## `includeImages` (type: `boolean`): Extract images uploaded by reviewers ## `includeGdprSensitive` (type: `boolean`): Include reviewer names, profile links, and avatars. Set to false for GDPR compliance. ## `proxyConfiguration` (type: `object`): REQUIRED. Amazon aggressively blocks anonymous datacenter IPs, so an Apify residential proxy is mandatory for cookie-free scraping. ## `maxConcurrency` (type: `integer`): Maximum number of concurrent browser pages ## `requestTimeout` (type: `integer`): Timeout for each page request in seconds ## `retryCount` (type: `integer`): Number of retries for failed requests / blocked sessions ## Actor input object example ```json { "productUrls": [ "https://www.amazon.com/dp/B09X7MPX8L" ], "country": "amazon.com", "maxReviews": 15, "sortBy": "helpful", "filterByStar": "", "includeImages": true, "includeGdprSensitive": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxConcurrency": 1, "requestTimeout": 60, "retryCount": 3 } ``` # Actor output Schema ## `reviews` (type: `string`): Dataset containing all scraped Amazon customer reviews. # 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://www.amazon.com/dp/B09X7MPX8L" ], "country": "amazon.com", "maxReviews": 15, "sortBy": "helpful", "includeImages": true, "includeGdprSensitive": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxConcurrency": 1, "requestTimeout": 60, "retryCount": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/amazon-reviews-scraper-pro").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://www.amazon.com/dp/B09X7MPX8L"], "country": "amazon.com", "maxReviews": 15, "sortBy": "helpful", "includeImages": True, "includeGdprSensitive": False, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, "maxConcurrency": 1, "requestTimeout": 60, "retryCount": 3, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/amazon-reviews-scraper-pro").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://www.amazon.com/dp/B09X7MPX8L" ], "country": "amazon.com", "maxReviews": 15, "sortBy": "helpful", "includeImages": true, "includeGdprSensitive": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxConcurrency": 1, "requestTimeout": 60, "retryCount": 3 }' | apify call crawlerbros/amazon-reviews-scraper-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/amazon-reviews-scraper-pro", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Amazon Reviews Scraper Pro", "description": "Extract customer reviews from any Amazon product across 19+ domains with star-rating filtering and sort options. Same cookie-free, residential-proxy architecture as the base scraper.", "version": "1.0", "x-build-id": "5G2UdRi6WUn6Wb5CY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~amazon-reviews-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-amazon-reviews-scraper-pro", "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/crawlerbros~amazon-reviews-scraper-pro/runs": { "post": { "operationId": "runs-sync-crawlerbros-amazon-reviews-scraper-pro", "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/crawlerbros~amazon-reviews-scraper-pro/run-sync": { "post": { "operationId": "run-sync-crawlerbros-amazon-reviews-scraper-pro", "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", "proxyConfiguration" ], "properties": { "productUrls": { "title": "Product URLs", "type": "array", "description": "List of Amazon product URLs to scrape reviews from. Supports /dp/, /gp/product/, and /product/ URL formats across 19+ Amazon domains.", "items": { "type": "string" } }, "country": { "title": "Amazon Domain", "enum": [ "amazon.com", "amazon.co.uk", "amazon.de", "amazon.fr", "amazon.it", "amazon.es", "amazon.ca", "amazon.com.au", "amazon.co.jp", "amazon.in", "amazon.com.br", "amazon.com.mx", "amazon.nl", "amazon.sg", "amazon.ae", "amazon.sa", "amazon.pl", "amazon.se", "amazon.com.tr" ], "type": "string", "description": "Amazon country domain to scrape from. URLs from a different domain are honored automatically.", "default": "amazon.com" }, "maxReviews": { "title": "Max Reviews per Product", "minimum": 1, "maximum": 15, "type": "integer", "description": "Maximum number of reviews to scrape per product (1-15). Cookie-free mode is capped by Amazon's inline /dp/ review block, which renders ~8-13 top reviews per ASIN with no pagination.", "default": 15 }, "sortBy": { "title": "Sort Reviews By", "enum": [ "helpful", "recent" ], "type": "string", "description": "How to sort the reviews", "default": "helpful" }, "filterByStar": { "title": "Filter by Star Rating", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter reviews by specific star rating (1-5). Leave empty for all ratings.", "default": "" }, "includeImages": { "title": "Include Review Images", "type": "boolean", "description": "Extract images uploaded by reviewers", "default": true }, "includeGdprSensitive": { "title": "Include GDPR Sensitive Data", "type": "boolean", "description": "Include reviewer names, profile links, and avatars. Set to false for GDPR compliance.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "REQUIRED. Amazon aggressively blocks anonymous datacenter IPs, so an Apify residential proxy is mandatory for cookie-free scraping.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum number of concurrent browser pages", "default": 1 }, "requestTimeout": { "title": "Request Timeout (seconds)", "minimum": 30, "maximum": 180, "type": "integer", "description": "Timeout for each page request in seconds", "default": 60 }, "retryCount": { "title": "Retry Count", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of retries for failed requests / blocked sessions", "default": 3 } } }, "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 } } } } } } } } } } ```