{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper - Price, ASIN, Ratings & Product Data", "description": "Scrape Amazon product data by keyword, ASIN or URL, no API key needed. Get price, list price, discount, rating, ratings breakdown, review count, best-seller ranks, Buy Box seller, variations, specs, images and videos. Filter by price, rating, reviews, Prime and brand. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "MV4Y5yKEQidbIDeoh" }, "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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "One or more keywords to search on the selected marketplace (e.g. 'wireless earbuds', 'coffee grinder'). One run fans out over every keyword. Combine with the filters below.", "items": { "type": "string" } }, "searchQuery": { "title": "Search keyword (single)", "type": "string", "description": "A single keyword to search (alias of Search keywords for backward compatibility). Use Search keywords for multiple." }, "asins": { "title": "ASINs", "type": "array", "description": "One or more Amazon ASINs (the 10 character product IDs, e.g. B0CHWRXH8B). Combined with the marketplace 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/...). They keep their own domain.", "items": { "type": "string" } }, "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 keywords and ASINs. Product URLs keep their own domain.", "default": "com" }, "maxProducts": { "title": "Max products", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of products to collect across all keywords, ASINs and URLs." }, "maxPages": { "title": "Max search pages per keyword", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many search result pages to page through per keyword before stopping (default 20).", "default": 20 }, "sortBy": { "title": "Sort search results by", "enum": [ "relevance", "price_asc", "price_desc", "rating", "newest", "featured" ], "type": "string", "description": "Order search results before collecting them. Applies to keyword searches only.", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only keep products at or above this price (in the marketplace currency)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only keep products at or below this price (in the marketplace currency)." }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep products with an average rating at or above this value (1-5)." }, "minReviews": { "title": "Minimum number of reviews", "minimum": 0, "type": "integer", "description": "Only keep products with at least this many ratings/reviews." }, "primeOnly": { "title": "Prime eligible only", "type": "boolean", "description": "Only keep products that are Prime eligible.", "default": false }, "brand": { "title": "Brand contains", "type": "string", "description": "Only keep products whose brand contains this text (case-insensitive). Requires full product details." }, "postalCode": { "title": "Delivery ZIP / postal code", "type": "string", "description": "Optional delivery location for location-aware price and availability (best-effort; falls back to the default location if the marketplace does not accept it)." }, "withDetails": { "title": "Fetch full product details", "type": "boolean", "description": "When enabled, each search result is opened for the full product page (Buy Box seller, bullet features, images, specs, best seller ranks, ratings breakdown, variations). ASINs and product URLs always fetch the full 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 } } }, "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 } } } } } } } } } }