{
"openapi": "3.0.1",
"info": {
"title": "Amazon Reviews Scraper — Product Reviews & Ratings",
"description": "Scrape Amazon product reviews, ratings, and Q&A data. Extract reviewer name, rating, review text, date, verified purchase status, and helpfulness votes. Supports all Amazon domains (US, UK, DE, FR, ES, IT, etc.). Ideal for product research, sentiment analysis, and competitive intelligence.",
"version": "0.2",
"x-build-id": "VFBtMoCE7cI8EYcEg"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/rastriq~amazon-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-rastriq-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/rastriq~amazon-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-rastriq-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/rastriq~amazon-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-rastriq-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": [
"asins"
],
"properties": {
"asins": {
"title": "ASINs or product URLs",
"minItems": 1,
"type": "array",
"description": "One ASIN or full product URL per line. Accepts:
• Bare ASIN: B09G9FPHY6
• Product URL: https://www.amazon.es/dp/B09G9FPHY6
• Reviews URL: https://www.amazon.es/product-reviews/B09G9FPHY6
Different marketplaces can be mixed.",
"items": {
"type": "string"
}
},
"marketplace": {
"title": "Marketplace",
"enum": [
"amazon.es",
"amazon.com",
"amazon.de",
"amazon.fr",
"amazon.co.uk",
"amazon.it",
"amazon.com.br",
"amazon.com.mx",
"amazon.ca",
"amazon.com.au",
"amazon.co.jp",
"amazon.nl",
"amazon.pl",
"amazon.se"
],
"type": "string",
"description": "Amazon domain to use when only an ASIN is provided. Ignored when the input already contains a full URL with a domain.",
"default": "amazon.es"
},
"mode": {
"title": "What to scrape",
"enum": [
"reviews",
"products",
"both"
],
"type": "string",
"description": "Reviews only, product data only, or both in the same run.",
"default": "reviews"
},
"max_reviews": {
"title": "Max reviews per product",
"minimum": 1,
"maximum": 2000,
"type": "integer",
"description": "Maximum number of reviews to extract per product. Without cookies, the actor returns the ~5–10 reviews embedded in the product page. With cookies, it paginates the full review history (each page has ~10 reviews) until reaching this number or running out. Use a low value (10–50) for your first run.",
"default": 100
},
"delay_between_clicks": {
"title": "Delay between page navigations",
"minimum": 0.5,
"maximum": 10,
"type": "number",
"description": "Seconds to wait between paginated review pages. Increase if you see CAPTCHAs or empty pages.",
"default": 1.5
},
"delay_page_load": {
"title": "Page load wait",
"minimum": 1,
"maximum": 15,
"type": "number",
"description": "Seconds to wait after a page loads before extracting data. Increase on slow proxies.",
"default": 3
},
"use_proxy": {
"title": "Use Apify proxy",
"type": "boolean",
"description": "Routes traffic through Apify's proxy network. Strongly recommended for Amazon. Disable only if you are debugging locally or have your own proxy.",
"default": true
},
"proxy_type": {
"title": "Proxy type",
"enum": [
"residential",
"datacenter",
"none"
],
"type": "string",
"description": "Residential is the most reliable but ~10–20x slower (heavy run-time cost). Datacenter is much faster and cheaper but Amazon blocks it more often — try it for speed and fall back to residential if you see CAPTCHAs / empty results. None disables the proxy.",
"default": "residential"
},
"block_media": {
"title": "Block images, video & fonts",
"type": "boolean",
"description": "Blocks downloading images/video/fonts (not needed to extract text). Cuts residential proxy bandwidth ~2-3x and speeds up runs. Disable only if you specifically need media bytes loaded.",
"default": true
},
"cookies": {
"title": "Amazon session cookies (JSON)",
"type": "array",
"description": "Optional. Required only if you want more reviews than the ~5–10 embedded in the product page. Paste your Amazon session cookies as a JSON array.
How to export (2 minutes, one-time):
1. Log into Amazon in Chrome on the marketplace you want (e.g. amazon.es)
2. Install the free Cookie-Editor extension
3. On the Amazon page, click the extension → Export → Export as JSON
4. Paste the result here
Cookies are saved to the Key-Value Store after the first run, so subsequent runs reuse them automatically. If they expire, the actor will tell you in the log."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}