{ "openapi": "3.0.1", "info": { "title": "Amazon Scraper - Products, Prices, Reviews & Best Sellers", "description": "Amazon scraper for search results, ASIN product details, top reviews and Best Sellers Top 100. Real local prices on 11 marketplaces. $1 per 1,000 results.", "version": "0.1", "x-build-id": "chJ6iVYkjFM5Z9Q1b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deanko~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deanko-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/deanko~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-deanko-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/deanko~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-deanko-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", "properties": { "keywords": { "title": "Search keywords", "type": "array", "description": "Amazon search terms, exactly as you would type them in the Amazon search box, e.g. `vitamin d3` or `wireless earbuds`. Each keyword returns products from the search results pages (title, price, rating, review count, image, sponsored flag and position), up to the limit set below.", "items": { "type": "string" } }, "asins": { "title": "Product details: ASINs or product URLs", "type": "array", "description": "ASINs (e.g. `B0764MS2Q2`) or full Amazon product URLs. Returns the full product page: brand, price, availability (stock), rating, review count, main image and bullet-point features. Each product is one result plus a product-detail charge.", "items": { "type": "string" } }, "reviewAsins": { "title": "Reviews: ASINs or product URLs", "type": "array", "description": "ASINs or product URLs to collect reviews for. Returns the top reviews Amazon shows on the product page (usually 8-10 per product): rating, title, text, date, country, variant, verified purchase and helpful votes. Reviewer names are not collected. The full review list needs an Amazon login and is not scraped.", "items": { "type": "string" } }, "bestsellerUrls": { "title": "Best Sellers category URLs (Top 100)", "type": "array", "description": "Amazon Best Sellers category URLs, e.g. `https://www.amazon.com/gp/bestsellers/hpc/3773931` or `https://www.amazon.com/Best-Sellers-Kitchen-Dining/zgbs/kitchen`. Returns ranks 1-100. About 60 of the 100 come with title, price, rating and reviews; the rest come with ASIN, rank and URL. Use URLs from the same Amazon store as the Marketplace setting below, so the proxy country matches.", "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "com", "ca", "co.uk", "de", "fr", "it", "es", "co.jp", "com.au", "in", "com.mx" ], "type": "string", "description": "Amazon store to scrape for keywords, ASINs and reviews. The proxy country is matched to this marketplace automatically, so you get local prices and stock.", "default": "com" }, "maxItemsPerKeyword": { "title": "Max products per keyword", "minimum": 1, "maximum": 300, "type": "integer", "description": "Stop after this many search results per keyword. The scraper follows search pagination until it reaches this number. Each product is one billable result, so this is also your cost cap per keyword.", "default": 20 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy is recommended; Amazon blocks datacenter IPs quickly. The country is set to match the marketplace automatically." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }