{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper - Price, ASIN, BSR, Reviews & Specs", "description": "Amazon product specs scraper: pull products by keyword or ASIN - price, list price and discount, star rating, review count, seller, Prime status, stock, every image, full specifications and best-seller rank (BSR). Currency is pinned so prices never drift with the proxy IP. amazon.com.", "version": "0.1", "x-build-id": "lPgBrhlbhvdRrU1tQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/flash_scraper~amazon-product-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-flash_scraper-amazon-product-data", "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/flash_scraper~amazon-product-data/runs": { "post": { "operationId": "runs-sync-flash_scraper-amazon-product-data", "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/flash_scraper~amazon-product-data/run-sync": { "post": { "operationId": "run-sync-flash_scraper-amazon-product-data", "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": { "searchTerms": { "title": "Search keywords", "type": "array", "description": "Keywords to search, e.g. ['laptop stand', 'standing desk']. Every matching product on the first results page is queued.", "default": [ "laptop stand" ], "items": { "type": "string" } }, "asins": { "title": "ASINs or product URLs", "type": "array", "description": "Specific products, as bare ASINs ('B077B9W343') or any Amazon product URL. Combine freely with keywords.", "default": [], "items": { "type": "string" } }, "domain": { "title": "Amazon marketplace", "enum": [ "com", "co.uk", "de", "fr", "it", "es", "ca", "com.mx", "com.au", "co.jp", "in", "com.br", "nl", "se", "pl", "ae", "sa" ], "type": "string", "description": "Which Amazon site to scrape. **Only amazon.com is verified working from shared cloud IPs** - measured 2026-08-03, every other marketplace returned a bot-check page from Apify's datacenter proxies. The others are left available because your own residential proxy may reach them, but treat them as unverified. Prices and availability are marketplace-specific.", "default": "com" }, "currency": { "title": "Force currency", "type": "string", "description": "Amazon prices in the currency of whichever IP requests the page, so the same product can come back as USD or MAD depending on the proxy exit node. This pins it. Leave blank to use the marketplace default.", "default": "USD" }, "fullDetail": { "title": "Fetch full product pages", "type": "boolean", "description": "On: one request per product for the complete record (features, all images, specifications, rank). Off: only the lighter fields visible on the search page, which is much faster and cheaper.", "default": true }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on products returned in one run. One keyword returns one page of Amazon search results, which is 16-27 products (measured n=10), so a single keyword cannot reach a cap far above that - add more keywords for more products.", "default": 50 }, "minRating": { "title": "Minimum star rating", "type": "string", "description": "e.g. 4.0 to keep only well-reviewed products. 0 or blank = no filter.", "default": "0" }, "maxPrice": { "title": "Maximum price", "type": "string", "description": "In the forced currency. 0 or blank = no filter.", "default": "0" }, "onlyPrime": { "title": "Only Prime-eligible products", "type": "boolean", "description": "Keep only products showing a Prime badge.", "default": false }, "onlyInStock": { "title": "Only products in stock", "type": "boolean", "description": "Needs 'Fetch full product pages' on, since stock status is not reliable on the search page.", "default": false }, "skipSponsored": { "title": "Skip sponsored results", "type": "boolean", "description": "Drop paid placements and keep only organic search results.", "default": false }, "delaySeconds": { "title": "Delay between requests", "type": "string", "description": "Seconds to pause between requests. Lowering it raises the chance Amazon's bot check stops the run early.", "default": "1.0" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy, datacenter group (the default). Re-measured 2026-08-12, n=22 requests per group: datacenter and residential block at the SAME rate - search pages 7/10 usable on both, product pages 9/12 datacenter vs 10/12 residential - and datacenter returned equal or better field fill (price and currency 100% vs 90%). Datacenter is not GB-metered, so it costs about 8x less for identical data. Select the RESIDENTIAL group only if you see a persistently high block rate.", "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 } } } } } } } } } }