{ "openapi": "3.0.1", "info": { "title": "⭐ Amazon Reviews Scraper: Verified & Star · $3.42/1k", "description": "Scrape Amazon customer reviews by ASIN: star rating, title, body, verified purchase, helpful votes and review images. 8 marketplaces. Use as MCP tool in Claude & AI agents.", "version": "0.1", "x-build-id": "VYpIT87jnuZ5TDsyz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~amazon-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-amazon-reviews", "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/themineworks~amazon-reviews/runs": { "post": { "operationId": "runs-sync-themineworks-amazon-reviews", "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/themineworks~amazon-reviews/run-sync": { "post": { "operationId": "run-sync-themineworks-amazon-reviews", "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", "properties": { "asins": { "title": "ASINs", "type": "array", "description": "Amazon ASINs or full product URLs. E.g. [\"B08N5KWB9H\"] or [\"https://www.amazon.com/dp/B08N5KWB9H\"].", "items": { "type": "string" } }, "marketplace": { "title": "Amazon marketplace", "enum": [ "amazon.com", "amazon.co.uk", "amazon.de", "amazon.fr", "amazon.co.jp", "amazon.in", "amazon.ca", "amazon.com.au" ], "type": "string", "description": "Amazon marketplace domain. Use that marketplace's own ASIN.", "default": "amazon.com" }, "maxReviews": { "title": "Max reviews per ASIN", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper limit on reviews returned per ASIN. Amazon publishes about 13 reviews per product page and no longer serves a public paginated review URL, so expect roughly 5 to 13 per ASIN whatever you set here. You are charged per review actually delivered, so a higher number costs nothing extra.", "default": 50 }, "sortBy": { "title": "Sort reviews by", "enum": [ "recent", "helpful" ], "type": "string", "description": "Order of the returned reviews. Amazon serves one fixed set of top reviews per product, so this sorts what the page returned rather than requesting a different set.", "default": "recent" }, "filterByStar": { "title": "Filter by star rating", "enum": [ "all", "five_star", "four_star", "three_star", "two_star", "one_star" ], "type": "string", "description": "Keep only reviews with this star rating. Applied to the reviews on the product page, so a narrow filter can return very few rows or none. Filtered-out reviews are never charged.", "default": "all" }, "includeInternational": { "title": "Include reviews from other countries", "type": "boolean", "description": "Amazon shows a \"reviews from other countries\" block on most listings, typically 5 of the 13 reviews. Every row is tagged with reviewSource (local or international) and reviewCountry. Turn this off to get only the marketplace's own reviews.", "default": true }, "residentialFallback": { "title": "Residential proxy fallback", "type": "boolean", "description": "Retry on a residential IP when the standard proxy is blocked, or when Amazon returns a product page it cut short before the reviews section. In a verification run every cut page that was retried on residential came back complete. Leave this on unless you would rather keep the cheaper pool and accept the lower yield. Capped at 2 retries per ASIN.", "default": true }, "proxyConfig": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is used by default. Amazon blocks the datacenter pool often, so leave the residential fallback on as well.", "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 } } } } } } } } } }