{ "openapi": "3.0.1", "info": { "title": "Amazon Product Scraper API: Search, Prices, ASINs & Ratings", "description": "Amazon product scraper and MCP tool: search Amazon by keyword in 15 marketplaces and get every product with ASIN, title, price, rating, reviews count, Best Seller and Amazon's Choice badges, bought last month, image and rank. No browser. Pay per product found, plus a small fee per 100 results.", "version": "0.1", "x-build-id": "C7ex1CR0LlVcfLE1u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plainrows~amazon-product-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plainrows-amazon-product-search", "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/plainrows~amazon-product-search/runs": { "post": { "operationId": "runs-sync-plainrows-amazon-product-search", "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/plainrows~amazon-product-search/run-sync": { "post": { "operationId": "run-sync-plainrows-amazon-product-search", "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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search keywords", "minItems": 1, "maxItems": 2000, "type": "array", "description": "What you would type in the Amazon search box, one per line: \"wireless earbuds\", \"yoga mat\", \"usb c charger 65w\". Up to 1,000 keywords per run.", "items": { "type": "string" } }, "marketplace": { "title": "Amazon marketplace", "enum": [ "US", "GB", "DE", "FR", "ES", "IT", "NL", "SE", "PL", "CA", "MX", "BR", "JP", "IN", "AU" ], "type": "string", "description": "Amazon site to search. Prices are in that marketplace's currency.", "default": "US" }, "maxProductsPerQuery": { "title": "Max products per keyword", "minimum": 10, "maximum": 700, "type": "integer", "description": "From 10 to 700 (about 50 products per Amazon results page). Each product returned is billed; see Pricing.", "default": 50 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "featured", "price_low_to_high", "price_high_to_low", "avg_customer_review", "newest_arrival" ], "type": "string", "description": "Amazon's own sort order for the results.", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Amazon price filter, whole amount in the marketplace currency (e.g. 20 = $20 on amazon.com). Leave empty for no limit." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Amazon price filter, whole amount in the marketplace currency. Leave empty for no limit." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only products rated at least this (0 = no filter). Filtered products are not billed.", "default": 0 }, "minReviews": { "title": "Minimum number of reviews", "minimum": 0, "type": "integer", "description": "Keep only products with at least this many ratings (0 = no filter). Filtered products are not billed.", "default": 0 }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Also return sponsored (ad) placements, flagged isSponsored: true and billed like other products. Off by default: only organic results.", "default": false }, "languageCode": { "title": "Language (optional)", "enum": [ "en_US", "en_GB", "en_AU", "en_IN", "es_US", "es_ES", "es_MX", "de_DE", "fr_FR", "it_IT", "nl_NL", "pl_PL", "pt_BR", "ja_JP", "zh_CN", "zh_TW", "cs_CZ", "tr_TR", "ar_AE" ], "type": "string", "description": "Amazon interface language, e.g. fr_FR on amazon.ca or es_US on amazon.com. Leave empty for the marketplace default." } } }, "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 } } } } } } } } } }