{ "openapi": "3.0.1", "info": { "title": "Amazon Product Price & Reviews Scraper", "description": "Scrape Amazon products by ASIN, URL or search query across amazon.com, .co.uk, .de, .es, .com.mx and more. Extract title, price, list price, rating, reviews, Buy Box seller, images and stock to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "cAJW60S8U4ZVO5hLh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-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/scrapers_lat~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-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/scrapers_lat~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-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": { "maxProducts": { "title": "Max products", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of products to collect. Optional." }, "withDetails": { "title": "Fetch full product details", "type": "boolean", "description": "When enabled, each product from a search query is opened and enriched with the full product page (Buy Box seller, bullet features, images, best seller rank, variations). ASINs and product URLs always fetch the full product page.", "default": true }, "withDescription": { "title": "AI: clean & translate title/description (paid add-on)", "type": "boolean", "description": "Opt-in AI add-on (paid plans only), off by default. Produce a concise clean product name, an English title, and a plain-language description summary. Charged only when the model returns usable output.", "default": false }, "withAttributes": { "title": "AI: extract attributes & category (paid add-on)", "type": "boolean", "description": "Opt-in AI add-on (paid plans only), off by default. Extract structured product attributes/specs and a broad product category from the title, description and specs. Charged only when the model returns usable output.", "default": false }, "asins": { "title": "ASINs", "type": "array", "description": "One or more Amazon ASINs (the 10 character product IDs, e.g. B0CHWRXH8B). Combined with the domain below.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Full Amazon product page URLs (any marketplace, e.g. https://www.amazon.com/dp/B0CHWRXH8B or https://www.amazon.co.uk/dp/...).", "items": { "type": "string" } }, "searchQuery": { "title": "Search query", "type": "string", "description": "A keyword to search on the selected domain (e.g. 'wireless earbuds'). Returns matching products up to Max products." }, "domain": { "title": "Amazon marketplace", "enum": [ "com", "co.uk", "de", "es", "fr", "it", "ca", "com.mx", "com.br", "com.au", "co.jp", "in", "nl", "se", "pl" ], "type": "string", "description": "The Amazon marketplace to use for ASINs and the search query. Product URLs keep their own domain.", "default": "com" } } }, "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 } } } } } } } } } }