{ "openapi": "3.0.1", "info": { "title": "Amazon Reviews Scraper", "description": "[UPDATED] Scrape Amazon reviews per product! Filter by stars, keywords, media & verified purchases. Extract global reviews (20+ regions). Export JSON/CSV. Perfect for market research & SEO.", "version": "0.5", "x-build-id": "MboeXddXVgtxcKg5F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/web_wanderer~amazon-reviews-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-web_wanderer-amazon-reviews-extractor", "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/web_wanderer~amazon-reviews-extractor/runs": { "post": { "operationId": "runs-sync-web_wanderer-amazon-reviews-extractor", "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/web_wanderer~amazon-reviews-extractor/run-sync": { "post": { "operationId": "run-sync-web_wanderer-amazon-reviews-extractor", "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": [ "products" ], "properties": { "personal_data": { "title": "Include personal data", "type": "boolean", "description": "Scrape personal data (e.g., names, emails, identifiers). **GDPR (EU)** and **CCPA (California)** compliance required. Ensure legal justification or user consent.", "default": false }, "products": { "title": "Start ASINs/URLs", "uniqueItems": true, "type": "array", "description": "The ASINs or URLs of the product you want to retrieve. For example:\n- Product URL: https://www.amazon.com/Logitech-LIGHTSPEED-Wireless-Gaming-Mouse/product-reviews/B07CMS5Q6P/ref=cm_cr_getr_mb_paging_btm_2?ie=UTF8&reviewerType=all_reviews&pageNumber=2&formatType=current_format\n- Product ID: B07MVJZQTC", "items": { "type": "string" } }, "limit": { "title": "pages to scrape per product", "minimum": 1, "maximum": 50, "type": "integer", "description": "Set number of pages to scrape, Amazon limits the number to 10 pages per product which are 100 review max. You can get more by setting Stars (one star, two stars, etc.), changing Variant, and Sort type.", "default": 20 }, "sort": { "title": "Sort by", "enum": [ "helpful", "recent" ], "type": "string", "description": "Select Sort type", "default": "helpful" }, "stars": { "title": "Filter multiple stars", "type": "array", "description": "Select the stars you want to scrape. You can select multiple stars", "items": { "type": "string", "enum": [ "five_star", "four_star", "three_star", "two_star", "one_star" ], "enumTitles": [ "5 star", "4 star", "3 star", "2 star", "1 star" ] } }, "all_stars": { "title": "All Stars Mode (up to 500 review per product)", "type": "boolean", "description": "Scrape up to 100 review per star", "default": false }, "rating": { "title": "Rating stars", "enum": [ "all", "five_star", "four_star", "three_star", "two_star", "one_star", "positive", "critical" ], "type": "string", "description": "Select reviews rating. This will filter reviews based on the stars.", "default": "all" }, "keywords": { "title": "Filter by keywords", "uniqueItems": true, "type": "array", "description": "Enter keywords that the review must have.", "items": { "type": "string" } }, "avp_reviews": { "title": "Only verified purchase", "type": "boolean", "description": "Return only reviews that have the verified purchase badge.", "default": false }, "include_variants": { "title": "Include all variants reviews", "type": "boolean", "description": "Whether to return reviews for product variants.", "default": true }, "start_date": { "title": "Start date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Inclusive start of date range, format YYYY-MM-DD, e.g. 2025-06-01" }, "end_date": { "title": "End date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Inclusive end of date range, format YYYY-MM-DD, e.g. 2025-06-30" }, "scrape_image_reviews": { "title": "Scrape reviews with images", "type": "boolean", "description": "Scrape reviews that contain images.", "default": false }, "scrape_video_reviews": { "title": "Scrape reviews with videos", "type": "boolean", "description": "Scrape reviews that contain videos.", "default": false }, "region": { "title": "Amazon ASINs domain", "enum": [ "amazon.com", "amazon.ca", "amazon.de", "amazon.fr", "amazon.co.uk", "amazon.it", "amazon.es", "amazon.com.au", "amazon.co.jp", "amazon.com.br", "amazon.com.mx", "amazon.nl", "amazon.ie", "amazon.se", "amazon.com.tr", "amazon.ae", "amazon.sg", "amazon.sa", "amazon.pl", "amazon.com.be", "amazon.eg", "amazon.in" ], "type": "string", "description": "Select domain", "default": "amazon.com" }, "language": { "title": "Reviews language", "enum": [ "all", "en", "es", "fr", "de", "pt", "it", "nl", "pl", "sv", "cs", "zh_CN", "zh_TW", "ja", "ko", "ar", "tr" ], "type": "string", "description": "Filter reviews based on review language", "default": "all" } } }, "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 } } } } } } } } } }