{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper — Details, Prices & Availability by ASIN", "description": "Amazon product details by ASIN or URL, 20 marketplaces. One row per product: title, brand, buybox price, list price, availability, in stock, rating, ratings count, images, bullet points, description, details table, Best Sellers Rank (BSR). Free filters: in stock only, max price. No login.", "version": "1.3", "x-build-id": "T9uRnKcFcGaW57PXi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kestrel~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kestrel-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/kestrel~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-kestrel-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/kestrel~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-kestrel-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 or product URLs", "uniqueItems": true, "type": "array", "description": "Amazon ASINs or product URLs, e.g. [\"B0CHWRXH8B\", \"https://www.amazon.de/dp/B09B8V1LZ3\"]. A URL's marketplace is used as is; a bare ASIN uses `domain`. Each ASIN + marketplace is fetched (one page) and billed once per run, $0.004. Use for \"price, stock and details of these ASINs\", \"is this in stock\", \"price history\" (schedule the same list daily and keep the rows). An unknown ASIN (404) or a page Amazon blocks costs nothing and is reported in a status row.", "default": [], "items": { "type": "string" } }, "domain": { "title": "Marketplace", "type": "string", "description": "Marketplace for bare ASINs, e.g. \"co.uk\" for amazon.co.uk. Default \"com\". One of: com, co.uk, de, fr, it, es, ca, com.au, co.jp, in, com.mx, com.br, nl, se, pl, sa, ae, sg, com.tr, com.be. Prices come in that marketplace's currency; the same ASIN on two marketplaces is two products. Outside \"com\" choose RESIDENTIAL in proxyConfiguration so the buybox price and stock line appear (the run routes through the marketplace's country by itself). Ignored for full URLs.", "default": "com" }, "inStockOnly": { "title": "Only products in stock", "type": "boolean", "description": "true = keep only products whose page says they are in stock; unavailable products and products whose stock cannot be read are dropped before billing. Default false (every product is delivered, with in_stock true, false or null). Use for \"which of these are in stock\" and stock checks across a catalogue: dead listings cost nothing.", "default": false }, "maxPrice": { "title": "Only products priced at or below", "minimum": 0, "maximum": 10000000, "type": "number", "description": "Keep only products whose buybox price is at or below this number in the marketplace's currency, e.g. 100. 0 (default) = no price filter. Products with no visible price are dropped too, so it also skips paying for rows without a price. Filtered products are never charged.", "default": 0 }, "sessions": { "title": "Parallel sessions", "minimum": 1, "maximum": 16, "type": "integer", "description": "Parallel proxy sessions (one egress IP each), 1 to 16, e.g. 4 (default 4). More is faster for long ASIN lists; each session is paced separately.", "default": 4 }, "perIp": { "title": "Requests per second per IP", "minimum": 0.1, "maximum": 2, "type": "number", "description": "Requests per second per session, 0.1 to 2 (default 0.5). Amazon tolerates about 0.5/s per IP; faster causes captchas, not speed. Leave the default.", "default": 0.5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy, default {\"useApifyProxy\": true} (datacentre), enough for amazon.com. For any other marketplace pass {\"useApifyProxy\": true, \"apifyProxyGroups\": [\"RESIDENTIAL\"]}: the run routes it through the marketplace's own country, which is what makes the buybox price and stock line appear. A captcha or 503 rotates the IP (up to 8 tries per product); after two refusals in a row the run moves to residential proxies by itself.", "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 } } } } } } } } } }