{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper - Price, ASIN, BSR, Reviews & Specs", "description": "Scrape Amazon 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. Currency is pinned so prices never drift with the proxy IP. Verified on amazon.com. No API key.", "version": "0.1", "x-build-id": "4526UxSwZ7RbxIgYT" }, "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, seller, 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.", "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 with the RESIDENTIAL group. Amazon blocks shared datacenter IPs — measured 2026-08-10: the same search returned a 2 kb block page and 0 products on datacenter, and 3 of 3 products on residential. Residential is required, not optional.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }