{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper - Search, Prices, Ratings & Details", "description": "Amazon product scraper: search by keyword or category URL (US, CA, MX, BR, ES...) and get ASIN, title, price, list price, rating, reviews, bestseller rank, images, bullets, variants and seller. No login. From US$1.50 per 1,000 products.", "version": "0.1", "x-build-id": "wkPvfyuNHue9kwTtY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fabrikit~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fabrikit-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/fabrikit~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-fabrikit-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/fabrikit~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-fabrikit-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "One search per entry, like typing it in the Amazon search box (for example: laptop stand, wireless earbuds).", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Amazon search result, category (/s?rh=..., /b?node=...) or product (/dp/ASIN) URLs. The marketplace is taken from each URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "asins": { "title": "ASINs", "type": "array", "description": "Product ASINs to fetch directly (10 characters, for example B0BT9MG6VT). Each one is returned with full product details.", "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "amazon.com", "amazon.ca", "amazon.com.mx", "amazon.com.br", "amazon.es", "amazon.co.uk", "amazon.de", "amazon.fr", "amazon.it", "amazon.nl", "amazon.com.au", "amazon.in", "amazon.co.jp" ], "type": "string", "description": "Amazon store used for keyword searches and ASINs. Some stores (amazon.co.uk, .de, .fr, .it) show stronger bot protection and need residential proxies.", "default": "amazon.com" }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many products in total (across all searches).", "default": 30 }, "maxPagesPerQuery": { "title": "Max result pages per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "Result pages to read per keyword or URL. Amazon shows 16-60 products per page and usually stops after 7-20 pages.", "default": 3 }, "includeDetails": { "title": "Product details", "type": "boolean", "description": "Open every product page to add brand, bestseller rank, bullets, images, specifications, variants and seller. Billed as an extra event per product and slower.", "default": false }, "includeSponsored": { "title": "Include sponsored results", "type": "boolean", "description": "Keep results marked as sponsored ads. Off by default so you get organic listings.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price-asc", "price-desc", "review-rank", "newest" ], "type": "string", "description": "Sort order for keyword and category searches.", "default": "relevance" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "number", "description": "Only products priced at or above this amount (marketplace currency). Leave empty for no limit." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "number", "description": "Only products priced at or below this amount (marketplace currency). Leave empty for no limit." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Amazon blocks datacenter IPs often. The actor starts on datacenter proxies and switches to RESIDENTIAL automatically after repeated blocks.", "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 }, "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 } } } } } } } } } }