{ "openapi": "3.0.1", "info": { "title": "Amazon Bestsellers Tracker: New Releases & Rank Changes", "description": "Get the Best Sellers or New Releases chart of any Amazon category, ranks 1-100, and see how each product moved since your last run: ASIN, title, price, rating, reviews, rank change. 20 marketplaces (US, UK, DE, JP...). Monitor mode saves only new or moved rows. $3 per 1,000 rows; errors are free.", "version": "1.0", "x-build-id": "AjNHhkI0P0JhXqA2a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~amazon-bestsellers-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-amazon-bestsellers-tracker", "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/tenfoldfleet~amazon-bestsellers-tracker/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-amazon-bestsellers-tracker", "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/tenfoldfleet~amazon-bestsellers-tracker/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-amazon-bestsellers-tracker", "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": { "categoryUrls": { "title": "Best Sellers or New Releases URLs", "type": "array", "description": "Amazon list pages from any supported marketplace, e.g. https://www.amazon.com/gp/bestsellers/electronics or https://www.amazon.de/gp/new-releases/books. Each URL is one list of up to 100 ranked products. Movers & Shakers lists are not supported.", "items": { "type": "string" } }, "categories": { "title": "Categories (alternative to URLs)", "type": "array", "description": "Category paths as they appear after /gp/bestsellers/ in the Amazon URL, e.g. electronics, books, toys-and-games, kitchen/289913. Combined with the list types and the marketplace below.", "items": { "type": "string" } }, "listTypes": { "title": "List types (for categories)", "type": "array", "description": "Which lists to fetch for each category above. URLs carry their own list type.", "items": { "type": "string", "enum": [ "bestsellers", "new-releases" ], "enumTitles": [ "Best Sellers", "New Releases" ] }, "default": [ "bestsellers" ] }, "marketplace": { "title": "Marketplace (for categories)", "enum": [ "com", "co.uk", "de", "fr", "it", "es", "nl", "com.be", "se", "pl", "com.tr", "ca", "com.mx", "com.br", "co.jp", "in", "com.au", "sg", "ae", "sa" ], "type": "string", "description": "Amazon site for the categories above. URLs carry their own marketplace.", "default": "com" }, "maxRank": { "title": "Ranks per list", "minimum": 1, "maximum": 100, "type": "integer", "description": "Keep ranks 1 to this number (max 100). 50 or less loads one page per list.", "default": 100 }, "monitorMode": { "title": "Monitor mode (only new or moved products)", "type": "boolean", "description": "Compare each list with the previous run that used the same state store and save (and charge) only products that are new on the list or changed rank. The first run saves the full list as the baseline. previousRank, rankChange and isNew are filled in either way once a previous run exists.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Named key-value store in your Apify account that keeps the last ranks of each list. Use a different name for separate trackers.", "default": "amazon-bestsellers-tracker-state" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is used by default (included on the free plan); each blocked attempt is retried on a new IP. Residential proxy is not supported. Free plan: the $5 monthly credit covers about 1,600 rows.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }