{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper | Prices, ASIN & Reviews", "description": "Scrape Amazon products without the official API. Extract prices, ASIN, ratings, reviews, brand, images, specs, seller info and breadcrumbs from search, category, bestseller and product URLs. Fast HTTP scraping with automatic browser fallback and residential proxy support.", "version": "1.8", "x-build-id": "m1HnFxQQSGNcxJxzh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rp_openpro.ai~amazon-ultimate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rp_openpro.ai-amazon-ultimate-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/rp_openpro.ai~amazon-ultimate-scraper/runs": { "post": { "operationId": "runs-sync-rp_openpro.ai-amazon-ultimate-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/rp_openpro.ai~amazon-ultimate-scraper/run-sync": { "post": { "operationId": "run-sync-rp_openpro.ai-amazon-ultimate-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": [ "categoryUrls" ], "properties": { "categoryUrls": { "title": "Amazon start URLs", "type": "array", "description": "Amazon search, category, bestseller, or product URLs. Example: https://www.amazon.com/s?k=keyboard or https://www.amazon.com/dp/B08XXXX" }, "maxItemsPerStartUrl": { "title": "Max results (per start URL)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum products to scrape for each start URL.", "default": 100 }, "maxSearchPagesPerStartUrl": { "title": "Maximum search pages (per start URL)", "minimum": 1, "maximum": 400, "type": "integer", "description": "Maximum listing pages to crawl per start URL. Amazon often caps keyword search at ~7 pages — combine category + keyword for deeper coverage.", "default": 7 }, "scrapeProductDetails": { "title": "Scrape product details", "type": "boolean", "description": "When enabled, opens each product page for full metadata (features, specs, seller, images). Disable for faster listing-only mode.", "default": true }, "useBrowserFallback": { "title": "Use browser fallback on blocks", "type": "boolean", "description": "If Amazon returns a captcha/block page over HTTP, retry with a headless browser through your proxy.", "default": true }, "detailConcurrency": { "title": "Product detail concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many product detail pages to scrape in parallel after listing discovery.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration (override)", "type": "object", "description": "Leave empty for optimal cost — uses fast datacenter proxy with automatic residential fallback on blocks. Override only if you have specific proxy requirements." } } }, "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 } } } } } } } } } }