{ "openapi": "3.0.1", "info": { "title": "Keepa Scraper | Amazon Price History and Offers", "description": "Keepa scraper for Amazon price history: search by keyword, ASIN or product link and get buy box, Amazon, new and used prices, price history, live seller offers and stock, rating, reviews, sales rank drops and FBA fees. 20 products in 2 seconds, 82 fields each. No Keepa subscription or API key.", "version": "1.0", "x-build-id": "IyzqBRMrSRhCpoh4T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~keepa-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-keepa-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/silentflow~keepa-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-keepa-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/silentflow~keepa-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-keepa-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": { "searches": { "title": "🔎 Keywords", "type": "array", "description": "Words to search on Amazon, as you would type them in the search bar: air fryer, wireless earbuds, lego star wars. Each keyword returns the top products Keepa lists for it (about 20 on amazon.com, up to 50 on some marketplaces), each with its full Keepa data. Add more keywords to cover more products.", "items": { "type": "string" } }, "asins": { "title": "🏷️ ASINs", "type": "array", "description": "Amazon product ids, one per line: B0BN72FYFG, or an ISBN-10 for books (0590353403). Read on the marketplace picked below. A product Keepa does not track gives no row and is counted in the log.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Amazon or Keepa links", "type": "array", "description": "Paste product or search pages, the marketplace is read from the link:", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "marketplace": { "title": "🌍 Amazon marketplace", "type": "string", "description": "Pick the Amazon store, or type its code (uk, de, jp), its English name or its domain (amazon.co.uk). Prices come in that store's currency. Links keep the marketplace they point to.", "default": "us" }, "maxItems": { "title": "🔢 Max products", "minimum": 1, "type": "integer", "description": "Stop after this many products, across keywords, ASINs and links. A keyword gives its products in a few seconds; 100 ASINs take well under a minute. The cost grows with the number of products.", "default": 100 }, "historyDays": { "title": "📈 Price history (days)", "minimum": 0, "type": "integer", "description": "How far back the buy box, Amazon, new, used and list price histories and the rating and review count histories go. 90 covers a quarter, 365 a year, 0 returns everything Keepa recorded since it started tracking the product (often several years, much larger rows).", "default": 90 }, "includeOffers": { "title": "🏪 Seller offers", "type": "boolean", "description": "Add the offers live on the product page: seller id, condition, price, shipping, FBA, Prime, stock. Turn it off for lighter rows when you only need prices and history.", "default": true }, "debugMode": { "title": "🐞 Debug mode", "type": "boolean", "description": "Writes detailed connection logs. Leave it off for normal runs.", "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 }, "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 } } } } } } } } } }