{ "openapi": "3.0.1", "info": { "title": "Amazon Search Products Scraper", "description": "Amazon Search Products Scraper — Extract Amazon search results including product names, prices, ratings, reviews, ASINs, images, availability, and product URLs. Useful for product research, price tracking, competitor analysis, market research, and e-commerce data collection.", "version": "0.1", "x-build-id": "5AO8mHrVSA7gJzZfB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fastdataapi~amazon-search-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fastdataapi-amazon-search-products-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/fastdataapi~amazon-search-products-scraper/runs": { "post": { "operationId": "runs-sync-fastdataapi-amazon-search-products-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/fastdataapi~amazon-search-products-scraper/run-sync": { "post": { "operationId": "run-sync-fastdataapi-amazon-search-products-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🔎 Keywords or Amazon search URLs", "type": "array", "description": "One search per line: a keyword (e.g. \"Playstation\") or a full Amazon search URL (e.g. https://www.amazon.com/s?k=TV). A pasted URL keeps its department, category, price range and sort filters on every page, and its marketplace overrides the Amazon domain field. Duplicate products within one search are returned once. Free plan: up to 20 products per run (all searches together) and 200 per month; paid plans have no limit.", "items": { "type": "string" } }, "amazonDomain": { "title": "📍 Amazon marketplace", "type": "string", "description": "Marketplace used for keywords: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es or amazon.ca. Any other value falls back to amazon.com (the log says so). Prices come in that marketplace's currency, with a delivery address in that country.", "default": "amazon.com" }, "proxyCountry": { "title": "📍 Proxy country", "enum": [ "AUTO", "US", "GB", "DE", "FR", "ES", "IT", "CA" ], "type": "string", "description": "Country the proxy connects from. AUTO matches the marketplace in the Amazon domain field (e.g. amazon.co.uk uses GB) for accurate prices, Prime badges and availability. A pasted URL for a different marketplace still connects from this country, so pin the matching country when you scrape another marketplace.", "default": "AUTO" }, "sortOrder": { "title": "🔃 Sort order", "enum": [ "relevanceblender", "price-asc-rank", "price-desc-rank", "review-rank", "date-desc-rank" ], "type": "string", "description": "How Amazon sorts the results. A pasted URL with its own sort keeps that sort.", "default": "relevanceblender" }, "maxPages": { "title": "🔢 Maximum pages per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many results pages to read for each search (about 20 products per page). The actor never reads more pages than the search actually has, even if you set this higher.", "default": 1 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Default: Apify residential proxy, because Amazon often blocks or limits requests without one. You can also use your own proxy URLs; they are tried first. If Amazon still blocks a request, the actor retries and switches to a residential proxy automatically, even when the proxy is turned off.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }