{ "openapi": "3.0.1", "info": { "title": "Amazon Review Scraper", "description": "Amazon Reviews Scraper extracts structured customer reviews from Amazon product pages, including ratings, text, titles, dates, variants, helpful votes, images, and review URLs. It supports pagination, proxy use, live dataset updates, and marketplace URL normalization.", "version": "0.0", "x-build-id": "Pcg0Gapef4dPU4HH4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devlory~amazon-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devlory-amazon-review-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/devlory~amazon-review-scraper/runs": { "post": { "operationId": "runs-sync-devlory-amazon-review-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/devlory~amazon-review-scraper/run-sync": { "post": { "operationId": "run-sync-devlory-amazon-review-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": [ "start_urls" ], "properties": { "start_urls": { "title": "Product or review URLs", "type": "array", "description": "Amazon product URLs or product review URLs to scrape. The ASIN is extracted from any Amazon marketplace URL, then opened on amazon.it in English.", "default": [ { "url": "https://www.amazon.it/product-reviews/B0DT17JXF2/?reviewerType=all_reviews" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "max_reviews_per_product": { "title": "Max reviews per product", "minimum": 0, "type": "integer", "description": "Maximum reviews to collect for each product. Set to 0 to continue until Amazon has no next page token.", "default": 0 }, "max_pages_per_product": { "title": "Max pages per product", "minimum": 0, "type": "integer", "description": "Maximum review pages to request for each product. Set to 0 for unlimited pages.", "default": 0 }, "reviewer_type": { "title": "Reviewer type", "enum": [ "all_reviews", "avp_only_reviews" ], "type": "string", "description": "Amazon reviewerType query parameter.", "default": "all_reviews" }, "filter_by_star": { "title": "Filter by star", "enum": [ "", "all_stars", "five_star", "four_star", "three_star", "two_star", "one_star", "positive", "critical" ], "type": "string", "description": "Optional Amazon filterByStar query parameter.", "default": "" }, "fallback_marketplaces": { "title": "Target marketplace", "type": "string", "description": "Deprecated. The scraper always opens ASINs on amazon.it with English language settings.", "default": "amazon.it" }, "use_proxy": { "title": "Use Apify residential proxy", "type": "boolean", "description": "Use Apify Residential Proxy for Amazon requests.", "default": true }, "proxy_country": { "title": "Proxy country", "type": "string", "description": "Deprecated. The scraper always uses IT for amazon.it.", "default": "IT" }, "max_retries": { "title": "Max retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum retries per product URL.", "default": 5 }, "max_concurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many products to scrape in parallel.", "default": 3 }, "delay_min_seconds": { "title": "Minimum page delay", "type": "number", "description": "Minimum delay between review pages for the same product.", "default": 1 }, "delay_max_seconds": { "title": "Maximum page delay", "type": "number", "description": "Maximum delay between review pages for the same product.", "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 } } } } } } } } } }