{ "openapi": "3.0.1", "info": { "title": "Amazon Bestsellers Scraper: Top 100 & New Releases", "description": "All 100 ranks of Amazon Best Sellers and New Releases, down its subcategories. $1.50 per 1,000 products. 22 stores; price, rating, offers, category path.", "version": "0.1", "x-build-id": "Uif9YAq61O2Ch6GlS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luzivanlt~amazon-bestsellers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luzivanlt-amazon-bestsellers-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/luzivanlt~amazon-bestsellers-scraper/runs": { "post": { "operationId": "runs-sync-luzivanlt-amazon-bestsellers-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/luzivanlt~amazon-bestsellers-scraper/run-sync": { "post": { "operationId": "run-sync-luzivanlt-amazon-bestsellers-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": { "categoryUrls": { "title": "Category links", "type": "array", "description": "Best Sellers or New Releases pages copied from Amazon, one per line, from any store listed under Amazon store: https://www.amazon.com/gp/bestsellers/electronics, a /Best-Sellers-…/zgbs/… link, or https://www.amazon.com/gp/new-releases/books (the https:// optional). A link keeps its own store and list. The Best Sellers front page (https://www.amazon.com/gp/bestsellers) reads the top list of every department. Movers & Shakers, Most Wished For and Most Gifted links are refused. Example: https://www.amazon.com/gp/bestsellers/electronics", "items": { "type": "string" } }, "marketplace": { "title": "Amazon store", "enum": [ "amazon.com", "amazon.ca", "amazon.com.mx", "amazon.com.br", "amazon.co.uk", "amazon.de", "amazon.fr", "amazon.it", "amazon.es", "amazon.nl", "amazon.com.be", "amazon.ie", "amazon.se", "amazon.pl", "amazon.com.tr", "amazon.ae", "amazon.sa", "amazon.eg", "amazon.in", "amazon.co.jp", "amazon.com.au", "amazon.sg" ], "type": "string", "description": "The Amazon store the categories below are read on, amazon.com by default. Category links keep their own store. Prices follow the visitor's location, and each product's currency says which currency its price is in. Example: amazon.de", "default": "amazon.com" }, "categories": { "title": "Categories", "type": "array", "description": "Categories to read without copying links, as the part of the link after /gp/bestsellers/: a department (electronics, books, kitchen) or a department and a category number (electronics/281407). An empty line reads every department. Amazon store and Lists apply to them. Example: electronics", "items": { "type": "string" } }, "listTypes": { "title": "Lists", "type": "array", "description": "Which of Amazon's lists to read for each category above: Best Sellers, New Releases, or both (each list is its own top 100). Category links keep their own list. Example: Best Sellers and New Releases. Default: Best Sellers.", "items": { "type": "string", "enum": [ "best_sellers", "new_releases" ], "enumTitles": [ "Best Sellers", "New Releases" ] }, "default": [ "best_sellers" ] }, "subcategoryDepth": { "title": "Subcategory levels", "minimum": 0, "maximum": 3, "type": "integer", "description": "How many levels of subcategories to read below each category, each with its own top 100: 0 reads only the category you gave, 1 adds its subcategories, 2 their subcategories too. The front page counts its departments as level 0. A department has 10 to 40 subcategories, so each level multiplies the products. Example: 1. Default 0, at most 3.", "default": 0 }, "maxRank": { "title": "Ranks per list", "minimum": 1, "maximum": 100, "type": "integer", "description": "Read each list down to this rank. Amazon ranks 100 products per list, 50 on each of its two pages: a limit of 50 or less reads page 1 only, which is faster. Example: 10 for the top ten of every list. Default 100.", "default": 100 }, "maxProductsPerStart": { "title": "Max products per link or category", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop each link or category after this many products, its subcategories included, and go on to the next. A list gives up to 100 products, so set it higher when you read subcategories. Example: 2000. Default 1,000, at most 20,000.", "default": 1000 } } }, "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 } } } } } } } } } }