{ "openapi": "3.0.1", "info": { "title": "Amazon Reviews Scraper: Advanced & Lightning-Fast ⚡", "description": "No Login Needed - Updated July 2025. Get thousands of Amazon reviews in seconds! Powerful filters, rich data, instant export.", "version": "0.0", "x-build-id": "wGF483ZckgdRyOHG0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neatrat~amazon-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neatrat-amazon-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/neatrat~amazon-reviews-scraper/runs": { "post": { "operationId": "runs-sync-neatrat-amazon-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/neatrat~amazon-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-neatrat-amazon-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": [ "asin" ], "properties": { "asin": { "title": "Product ASIN", "type": "string", "description": "Amazon product ASIN (e.g. B092ZDHJMN)" }, "region": { "title": "Amazon Region", "enum": [ "com", "de", "fr", "it", "es", "nl", "pl", "se" ], "type": "string", "description": "Amazon region/domain to scrape from", "default": "com" }, "startPage": { "title": "Start Page", "minimum": 1, "type": "integer", "description": "Page number to start scraping from (1 = first page)", "default": 1 }, "pagesToScrape": { "title": "Pages to Scrape", "minimum": 1, "type": "integer", "description": "How many pages of reviews to scrape (10 reviews per page)", "default": 10 }, "maxReviews": { "title": "Maximum Reviews", "minimum": 1, "type": "integer", "description": "Maximum number of reviews to return (after filtering)", "default": 100000 }, "sortBy": { "title": "Sort By", "enum": [ "top", "recent" ], "type": "string", "description": "Sort reviews by 'top' (most helpful) or 'recent' (most recent)", "default": "top" }, "verifiedPurchase": { "title": "Verified Purchase Only", "enum": [ "all", "verified" ], "type": "string", "description": "Filter for only verified purchase reviews ('all' or 'verified')", "default": "all" }, "ratings": { "title": "Ratings", "type": "array", "description": "Which star ratings to include (e.g. [5], [4,5], [1,2,3,4,5])" }, "mediaType": { "title": "Media Type", "enum": [ "all", "with_media_only" ], "type": "string", "description": "Filter for reviews with media (images/videos) only or all reviews", "default": "all" }, "keywords": { "title": "Keywords", "type": "array", "description": "Only include reviews containing these keywords (in title or body)", "items": { "type": "string" } }, "endDate": { "title": "End Date", "type": "string", "description": "Only include reviews up to this date (YYYY-MM-DD)" }, "recentDays": { "title": "Recent Days", "type": "integer", "description": "Only include reviews from the last N days (0 = no limit)", "default": 0 }, "uniqueOnly": { "title": "Unique Reviews Only", "type": "boolean", "description": "Only include unique reviews (by reviewId)", "default": true }, "autoKeywordExpansion": { "title": "Find More Reviews (Filter Combinations)", "type": "boolean", "description": "Search the same product multiple times with different filter combinations (star ratings, verified purchase, sort order) and with keywords mined from the reviews already found, then merge and deduplicate the results. Finds reviews that a single search misses.", "default": false }, "keywordPool": { "title": "Extra Search Keywords", "type": "array", "description": "Additional keywords to search reviews with when 'Find More Reviews' is enabled. Keywords found in already-scraped reviews are added automatically.", "default": [], "items": { "type": "string" } }, "autoExpandStars": { "title": "Search Each Star Rating", "type": "boolean", "description": "With 'Find More Reviews' enabled, also search each star rating (1-5) separately.", "default": true }, "autoExpandVerified": { "title": "Search Verified and All Reviews", "type": "boolean", "description": "With 'Find More Reviews' enabled, also search verified-purchase-only reviews separately.", "default": true }, "maxKeywordBatches": { "title": "Max Keyword Batches", "minimum": 1, "type": "integer", "description": "Upper bound on how many mined keywords to search when 'Find More Reviews' is enabled.", "default": 25 }, "stopAfterNoNewKeywordBatches": { "title": "Stop After N Keyword Batches Without New Reviews", "minimum": 1, "type": "integer", "description": "Stop searching mined keywords after this many consecutive keywords return no new reviews.", "default": 3 }, "maxAutoQueryPlans": { "title": "Max Query Plans per Batch", "minimum": 1, "type": "integer", "description": "Upper bound on filter-combination searches per keyword when 'Find More Reviews' is enabled.", "default": 300 }, "maxAutoQueriesTotal": { "title": "Max Total Queries", "minimum": 1, "type": "integer", "description": "Upper bound on total searches across all keywords when 'Find More Reviews' is enabled.", "default": 600 }, "autoQueryConcurrency": { "title": "Query Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches to run at once when 'Find More Reviews' is enabled.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }