{ "openapi": "3.0.1", "info": { "title": "Amazon Search Scraper By Price, Brand & Rating Filters", "description": "Amazon Search Scraper finds products using keyword, price, brand, rating, category, and other filters. Extract product titles, prices, ratings, reviews, ASINs, sellers, and product URLs for market research, price tracking, competitor analysis, and product discovery.", "version": "0.1", "x-build-id": "yfgDmQrchowffxV1B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~amazon-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-amazon-search-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/api-empire~amazon-search-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-amazon-search-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/api-empire~amazon-search-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-amazon-search-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": { "searchTargets": { "title": "🔎 Keywords or Amazon search links", "type": "array", "description": "One entry per search. A plain keyword searches amazon.com; paste a country search link to search that marketplace instead.\n\nExamples:\n • `laptop`\n • `wireless headphones`\n • `https://www.amazon.co.uk/s?k=running+shoes`\n\nDefault: `laptop`, `wireless headphones`.", "items": { "type": "string" } }, "priceMin": { "title": "💵 Lowest price", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only keep products priced at or above this amount, in the marketplace's own currency. Example: `100`. Leave empty for no lower bound." }, "priceMax": { "title": "💵 Highest price", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only keep products priced at or below this amount, in the marketplace's own currency. Example: `500` — together with a lowest price of `100` that returns the $100-$500 band. Leave empty for no upper bound." }, "brandFilter": { "title": "🏷️ Brands", "type": "array", "description": "Only keep products from these brands. Use the brand exactly as Amazon spells it in its own brand list, e.g. `HP`, `Dell`, `Lenovo`. Add several to get any of them. Leave empty for all brands.", "items": { "type": "string" } }, "minRating": { "title": "⭐ Minimum star rating", "enum": [ "any", "4", "3", "2", "1" ], "type": "string", "description": "Only keep products whose average customer rating is at least this many stars. Products with no ratings yet are left out when a floor is set. Default: any rating." }, "minDiscountPercent": { "title": "🔻 Minimum discount %", "minimum": 0, "maximum": 99, "type": "integer", "description": "Only keep products reduced by at least this much off their list or typical price. Example: `40` keeps only items at 40% off or better. Products with no visible reduction are left out when this is above 0. Default: `0` (no discount floor)." }, "onlyDiscounted": { "title": "🏷️ Reduced items only", "type": "boolean", "description": "Keep only products that are currently below their list or typical price, whatever the size of the reduction. Default: off." }, "includeOtherOffers": { "title": "📦 Read alternate offers", "type": "boolean", "description": "Fill in `offerCount`, `lowestOtherPrice`, `hasUsedOffer` and `secondaryOffer` from the other-sellers line on each result. Switch off to leave those four fields empty. Default: on." }, "productLimit": { "title": "📦 Products per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many products to collect for EACH entry above (not shared across them), counted after your filters have been applied. Example: 2 keywords x 25 = up to 50 products. Default: `10`." }, "resultOrder": { "title": "↕️ Result order", "enum": [ "relevanceblender", "price-asc-rank", "price-desc-rank", "review-rank", "date-desc-rank", "exact-aware-popularity-rank" ], "type": "string", "description": "The order Amazon ranks results in before they are collected. Every option here is one Amazon really offers on its own result page, and each row reports back the order Amazon confirmed in `selectedSort`. Default: Featured." }, "urls": { "title": "🔗 urls (legacy alias of Keywords)", "type": "array", "description": "Same meaning as the keywords field at the top. Used only when that field is empty.", "items": { "type": "string" } }, "maxResults": { "title": "🔢 maxResults (legacy alias of Products per search)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Same meaning as products per search. Used only when that field is empty." }, "sortBy": { "title": "↕️ sortBy (legacy alias of Result order)", "type": "string", "description": "Same meaning as result order. Used only when that field is empty. The original `recent` value is honoured as Newest Arrivals." }, "proxyConfiguration": { "title": "🌐 Connection settings", "type": "object", "description": "The prefilled setting is the one that works best for Amazon and is used automatically when this is left untouched." } } }, "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 } } } } } } } } } }