{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper — ASIN, URL or Keyword", "description": "Scrape Amazon products from plain ASINs, product URLs or search keywords. Price, list price, rating, reviews, Best Sellers Rank, availability, seller, images, variants and specs across 21 marketplaces. Blocked pages and products that no longer exist are never charged.", "version": "0.9", "x-build-id": "RWdUaBQpARpKdz6VM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leanfetch~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leanfetch-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/leanfetch~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-leanfetch-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/leanfetch~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-leanfetch-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": { "asins": { "title": "ASINs", "type": "array", "description": "Plain ASINs, one per line — no URL building needed. Example: B0CHX1W1XY", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Full Amazon product URLs. The marketplace is taken from each URL, so you can mix countries here.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "Search terms. The Actor walks the result pages and scrapes each product it finds.", "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "US", "CA", "MX", "BR", "UK", "DE", "FR", "IT", "ES", "NL", "SE", "PL", "BE", "IE", "TR", "AE", "SA", "IN", "JP", "AU", "SG" ], "type": "string", "description": "Which Amazon site to use for ASINs and keywords. Product URLs keep their own marketplace.", "default": "US" }, "language": { "title": "Language override", "type": "string", "description": "Optional. Forces the page language, e.g. en_GB on amazon.de. Leave empty for the marketplace default." }, "maxResultsPerKeyword": { "title": "Max products per keyword", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many products to take from each search term before moving on.", "default": 50 }, "maxItems": { "title": "Max products in total", "minimum": 0, "type": "integer", "description": "Hard cap across the whole run. 0 means no cap.", "default": 0 }, "searchResultsOnly": { "title": "Search rows only (cheaper, less detail)", "type": "boolean", "description": "Return the fields visible on the search page instead of opening every product. Much cheaper, but no Best Sellers Rank, specs or seller.", "default": false }, "proxyStrategy": { "title": "Proxy strategy", "enum": [ "AUTO", "RESIDENTIAL_ONLY" ], "type": "string", "description": "AUTO starts on datacenter IPs and switches a request to residential only when Amazon blocks it — this keeps your bill down. Choose RESIDENTIAL_ONLY for maximum success rate on hard categories.", "default": "AUTO" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Parallel requests. Lower it if you see a lot of blocks.", "default": 10 }, "datacenterAttempts": { "title": "Cheap attempts before paying for residential", "minimum": 0, "maximum": 6, "type": "integer", "description": "How many times a request is retried on cheap datacenter IPs before it escalates to residential. Higher means cheaper but slower; 0 escalates immediately.", "default": 3 } } }, "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 } } } } } } } } } }