{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper — Search Results, Prices, Reviews & Rank", "description": "Scrape Amazon product search results at scale. Extract product titles, prices, ratings, review counts, ASINs, images, Prime eligibility, seller info, and brand names from any Amazon marketplace. Supports Amazon.com, Amazon.co.uk, Amazon.de, Amazon.fr, Amazon.it, Amazon.es, Amazon.ca, Amazon.com.au, ", "version": "1.0", "x-build-id": "7vZ3vfjWroVXQTUhC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sovereigntaylor~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sovereigntaylor-amazon-product-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/sovereigntaylor~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-sovereigntaylor-amazon-product-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/sovereigntaylor~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-sovereigntaylor-amazon-product-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": [ "searchQuery" ], "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "The keyword or phrase to search for on Amazon. Examples: 'wireless headphones', 'laptop stand', 'organic coffee beans', 'yoga mat'. Supports multi-word queries.", "default": "wireless headphones" }, "marketplace": { "title": "Amazon Marketplace", "enum": [ "amazon.com", "amazon.co.uk", "amazon.de", "amazon.fr", "amazon.it", "amazon.es", "amazon.ca", "amazon.com.au", "amazon.co.jp", "amazon.in", "amazon.com.br" ], "type": "string", "description": "Which Amazon marketplace to scrape. Each marketplace has different products, prices, and availability.", "default": "amazon.com" }, "maxProducts": { "title": "Max Products", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of products to scrape. Amazon shows ~48 products per page. Set to 0 for unlimited (not recommended — use with caution). Suggested: 50-500 for most use cases.", "default": 10 }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "price-asc-rank", "price-desc-rank", "review-rank", "date-desc-rank" ], "type": "string", "description": "How to sort the Amazon search results. Default is Amazon's relevance ranking.", "default": "relevance" }, "minPrice": { "title": "Min Price", "minimum": 0, "type": "number", "description": "Minimum price filter in the marketplace's local currency. Leave at 0 for no minimum. Example: 10 means $10 on Amazon.com or 10 GBP on Amazon.co.uk.", "default": 0 }, "maxPrice": { "title": "Max Price", "minimum": 0, "type": "number", "description": "Maximum price filter in the marketplace's local currency. Leave at 0 for no maximum. Example: 100 means $100 on Amazon.com.", "default": 0 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum number of concurrent page requests. Amazon is aggressive with bot detection — lower values are safer. Recommended: 1-3. Higher values may trigger CAPTCHAs.", "default": 2 }, "maxRetries": { "title": "Max Retries Per Page", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry a failed page request. Amazon may block some requests — retries with delays help recover.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "STRONGLY RECOMMENDED: Amazon aggressively blocks datacenter IPs. Use Apify residential proxies for reliable results. Without proxies, scraping will likely fail after a few pages.", "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 } } } } } } } } } }