{
"openapi": "3.0.1",
"info": {
"title": "Amazon Product Scraper - Search Results, Prices & ASIN Lookup",
"description": "Scrape Amazon without the Product Advertising API: search by keyword, category, ASIN or product link and export price, list price, rating, review count, badges, sales volume and delivery. 23 marketplaces, no login, no start fee. CSV, Excel or JSON.",
"version": "1.0",
"x-build-id": "sSjVj9l8u2npirFaD"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zaver.api~amazon-product-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zaver.api-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/zaver.api~amazon-product-scraper/runs": {
"post": {
"operationId": "runs-sync-zaver.api-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/zaver.api~amazon-product-scraper/run-sync": {
"post": {
"operationId": "run-sync-zaver.api-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": {
"searchTerms": {
"title": "Search keywords",
"type": "array",
"description": "Keywords to search on Amazon, one per line. Each returns the products Amazon shows for that search, in ranking order.",
"items": {
"type": "string"
}
},
"products": {
"title": "ASINs or product links",
"type": "array",
"description": "ASINs (B07QSFHT27) or product links, one per line. Returns the current price, list price, rating and review count for each. A link from another Amazon site is looked up on that site.",
"items": {
"type": "string"
}
},
"categories": {
"title": "Category links or node IDs",
"type": "array",
"description": "Amazon category links (amazon.com/s?rh=n:172541, amazon.com/b?node=172541) or numeric browse node IDs, one per line. Returns every product listed in the category.",
"items": {
"type": "string"
}
},
"country": {
"title": "Marketplace",
"enum": [
"US",
"GB",
"DE",
"CA",
"IN",
"FR",
"IT",
"ES",
"JP",
"AU",
"MX",
"BR",
"NL",
"BE",
"SE",
"PL",
"IE",
"TR",
"AE",
"SA",
"EG",
"SG",
"ZA"
],
"type": "string",
"description": "Which Amazon site to scrape. A product or category link from another Amazon site overrides this for that input.",
"default": "US"
},
"maxResultsPerSearch": {
"title": "Max results per search",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Maximum products per keyword or category. Amazon shows about 20 pages per search, roughly 300 to 400 products.",
"default": 50
},
"sort": {
"title": "Sort by",
"enum": [
"relevance",
"price_low_to_high",
"price_high_to_low",
"reviews",
"newest",
"best_sellers"
],
"type": "string",
"description": "Order of search and category results.",
"default": "relevance"
},
"minPrice": {
"title": "Minimum price",
"minimum": 0,
"maximum": 10000000,
"type": "integer",
"description": "Only products at or above this price, in the marketplace's currency. 0 means no minimum.",
"default": 0
},
"maxPrice": {
"title": "Maximum price",
"minimum": 0,
"maximum": 10000000,
"type": "integer",
"description": "Only products at or below this price. 0 means no maximum.",
"default": 0
},
"brand": {
"title": "Brand",
"type": "string",
"description": "Optional. Only products from this brand, as Amazon spells it."
},
"primeOnly": {
"title": "Prime eligible only",
"type": "boolean",
"description": "Only products eligible for Prime delivery.",
"default": false
},
"fourStarsAndUp": {
"title": "Four stars and up",
"type": "boolean",
"description": "Only products rated four stars or higher.",
"default": false
},
"excludeSponsored": {
"title": "Exclude sponsored results",
"type": "boolean",
"description": "Drop ad placements from search and category results.",
"default": false
},
"maxItems": {
"title": "Max products in total",
"minimum": 0,
"maximum": 10000000,
"type": "integer",
"description": "Hard cap on products for the whole run. 0 means no cap.",
"default": 0
}
}
},
"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
}
}
}
}
}
}
}
}
}
}