{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper · 20 Marketplaces", "description": "Extract Amazon product data by ASIN or URL across 20 marketplaces. Returns price, list price, stock, ratings, star breakdown, monthly purchase volume, variants, A+ content, bestseller ranks, hi-res images and 40+ more fields. Pay-per-result, no login required.", "version": "1.0", "x-build-id": "KKdsDrwkh4P5sCKd4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-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/santamaria-automations~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-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/santamaria-automations~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-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": { "startUrls": { "title": "Product URLs", "type": "array", "description": "Amazon product page URLs. Any format works: `/dp/B09B8V1LZ3`, `/gp/product/B09B8V1LZ3`, or full slug URLs. Marketplace is auto-detected from the URL TLD. Combine with the ASINs field below — both are merged into one queue.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "asins": { "title": "ASINs", "type": "array", "description": "Bare ASINs (10 chars). The Marketplace Country below determines which Amazon to scrape these from. Combine with Product URLs above — both fields can be used together.", "items": { "type": "string", "pattern": "^[A-Z0-9]{10}$" } }, "country": { "title": "Marketplace Country", "enum": [ "US", "CA", "MX", "BR", "UK", "DE", "FR", "IT", "ES", "NL", "SE", "PL", "TR", "JP", "IN", "AU", "SG", "SA", "AE", "EG" ], "type": "string", "description": "Which Amazon marketplace to use for the ASINs field above. Ignored for entries in Product URLs (TLD is detected from the URL).", "default": "US" }, "language": { "title": "Language", "enum": [ "AUTO", "en", "de", "fr", "it", "es", "ja", "pt", "ar", "tr", "sv", "nl", "pl" ], "type": "string", "description": "Accept-Language preference sent to Amazon. `AUTO` matches the marketplace (e.g. de-DE for Germany, ja-JP for Japan) — recommended unless you need consistent English copy across all marketplaces.", "default": "AUTO" }, "maxItems": { "title": "Max Products", "minimum": 0, "type": "integer", "description": "Cap the total number of products scraped across this run. `0` = unlimited (scrape every URL + ASIN you provided).", "default": 0 }, "scrapeReviewSample": { "title": "Include Top Reviews", "type": "boolean", "description": "Return up to 8 top reviews per product (stars, title, author, date, body). Adds minimal cost. For the full review stream, use the Amazon Reviews Scraper.", "default": true }, "scrapeVariants": { "title": "Include Variant ASINs", "type": "boolean", "description": "Include the list of sibling variant ASINs (sizes, colors, packs). Variant detail pages are NOT separately fetched in v1 — only their ASINs and dimension labels are returned. Pass those ASINs in a follow-up run to enrich them.", "default": true }, "zipCode": { "title": "Delivery ZIP Code", "type": "string", "description": "Optional. Override the default delivery ZIP for the selected marketplace. Affects shown price, stock, and delivery date. Leave empty to use the marketplace default (e.g. 10001 for US, 10115 for DE, 75001 for FR)." }, "concurrency": { "title": "Concurrent Requests", "minimum": 1, "maximum": 50, "type": "integer", "description": "Products fetched in parallel. 5-10 is reliable for most workloads; higher (up to 50) is faster but increases the chance of transient blocks that force retries.", "default": 10 } } }, "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 } } } } } } } } } }