{ "openapi": "3.0.1", "info": { "title": "Amazon KDP Niche Research: BSR & Competition", "description": "Research Amazon KDP niches in bulk with real Kindle Store BSR, ratings, prices, book age, organic rank, and autocomplete suggestions. Compare transparent demand and competition scores, export CSV/JSON, and monitor changes through Apify API, schedules, webhooks, or MCP. From $0.66/1K books.", "version": "0.1", "x-build-id": "rcz3FdOruHXD0lQUe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~kdp-book-niche-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-kdp-book-niche-analyzer", "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/getascraper~kdp-book-niche-analyzer/runs": { "post": { "operationId": "runs-sync-getascraper-kdp-book-niche-analyzer", "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/getascraper~kdp-book-niche-analyzer/run-sync": { "post": { "operationId": "run-sync-getascraper-kdp-book-niche-analyzer", "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": [ "keyword" ], "properties": { "keyword": { "title": "Niche keyword", "type": "string", "description": "A Kindle Store keyword or genre to research, for example \"gratitude journal\", \"nurse planner\", or \"dog mom notebook\". This Actor searches the Kindle Store for this keyword and analyzes every matching book.", "default": "gratitude journal" }, "maxItems": { "title": "Max books", "minimum": 0, "type": "integer", "description": "Maximum number of book records to push to the dataset. Use 0 for no limit (returns every matching result on the first two Kindle Store search result pages). You are billed per book returned.", "default": 20 }, "fetchDetails": { "title": "Fetch book detail pages", "type": "boolean", "description": "When enabled (default), visits each book's own product page to add Best Sellers Rank, category, format (Kindle/Paperback/Hardcover), page count and publish date on top of the title, price, rating and review count already available from the search results. This is where the actual niche-research value comes from. Disable only for a faster, lighter run when you just need a raw list of matching titles.", "default": true }, "includeNicheSummary": { "title": "Include niche summary", "type": "boolean", "description": "When enabled (default), adds one extra summary record to a separate 'Niche summary' dataset with the median Best Sellers Rank, price band, review-count spread and format mix across all books analyzed in this run, plus a documented, BSR-anchored opportunity score. Requires 'Fetch book detail pages' to be enabled for the Best Sellers Rank component of the score; without it, the summary falls back to price and review-count signals only.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Amazon serves this data anonymously with no login required. Datacenter proxy targeted to the US is enabled by default so prices are returned in USD rather than a geolocated currency. Amazon also intermittently shows an automated-traffic checkpoint on a small fraction of requests even at low volume; this Actor already retries automatically when that happens, but if you see repeated failures, try enabling a residential proxy group instead.", "default": { "useApifyProxy": true, "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }