{
"openapi": "3.0.1",
"info": {
"title": "Amazon Product Scraper 🛒 (bulk keyword & ASIN export)",
"description": "Pull an Amazon catalogue in bulk: give it keywords, ASINs or product links and get a flat row per product with price, list price, discount, rating, review count, image, badges and rank position. Optionally opens each product page for brand, Best Sellers Rank, stock and seller.",
"version": "0.1",
"x-build-id": "T4f0np1PsPaqeXhtl"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~amazon-product-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-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/tagadanar~amazon-product-scraper/runs": {
"post": {
"operationId": "runs-sync-tagadanar-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/tagadanar~amazon-product-scraper/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-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": {
"searchKeywords": {
"title": "Search keywords",
"type": "array",
"description": "One keyword per line, exactly what you would type into Amazon's search box, e.g. wireless mouse. Every result page is read and you get one row per product: price, list price, rating, review count, image, badges, delivery wording and the rank position it held for that keyword.",
"items": {
"type": "string"
}
},
"asins": {
"title": "ASINs",
"type": "array",
"description": "Products you already know, one ASIN per line, e.g. B00PGB7OKM. They are read on the Amazon site chosen below, straight from the product page, so they come back with brand, Best Sellers Rank, stock wording, the seller and the image gallery.",
"items": {
"type": "string"
}
},
"productUrls": {
"title": "Product links",
"type": "array",
"description": "Full Amazon product links, e.g. https://www.amazon.de/dp/B0DK955V6Z. Each link keeps its own Amazon site, so you can pull the same product from amazon.com and amazon.de in one run.",
"items": {
"type": "string"
}
},
"domain": {
"title": "Amazon site",
"enum": [
"com",
"co.uk",
"de",
"fr",
"it",
"es"
],
"type": "string",
"description": "Which Amazon site the keywords and ASINs are read on. Product links override this per link.",
"default": "com"
},
"maxPagesPerKeyword": {
"title": "Result pages per keyword",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How deep to go for each keyword. Amazon itself stops paginating a keyword at 20 pages however many results it advertises, so 20 is the maximum and the actor stops at whatever Amazon actually offers, which is usually less.",
"default": 5
},
"maxItems": {
"title": "Max products",
"minimum": 1,
"maximum": 20000,
"type": "integer",
"description": "Stop the whole run after this many products. You are only charged for products actually delivered.",
"default": 200
},
"fetchProductDetails": {
"title": "Open each product page for the full record",
"type": "boolean",
"description": "Search cards do not carry brand, Best Sellers Rank, stock wording, the seller or the image gallery. Turn this on and every search hit also gets its product page read and merged into the same row. It makes the run slower and is billed separately, per product page that actually returned an offer. ASINs and product links you give directly always go through the product page, whether this is on or off.",
"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
}
}
}
}
}
}
}
}
}
}