{ "openapi": "3.0.1", "info": { "title": "Amazon Best Sellers Scraper: Top 100 by Category", "description": "Amazon Best Sellers scraper: the top 100 best sellers and new releases for any category on 12 Amazon marketplaces, with rank, ASIN, title, price, rating, reviews, image and category path. Subcategories too. Pay per product.", "version": "0.1", "x-build-id": "fnNtnfT8jGOwDNPiC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dtkfoundry~amazon-bestsellers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dtkfoundry-amazon-bestsellers", "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/dtkfoundry~amazon-bestsellers/runs": { "post": { "operationId": "runs-sync-dtkfoundry-amazon-bestsellers", "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/dtkfoundry~amazon-bestsellers/run-sync": { "post": { "operationId": "run-sync-dtkfoundry-amazon-bestsellers", "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": { "categories": { "title": "Categories", "type": "array", "description": "One per line: a Best Sellers or New Releases URL copied from Amazon (\"https://www.amazon.com/gp/bestsellers/electronics\", \"https://www.amazon.de/gp/new-releases/kitchen\"), or a category path (\"electronics\", \"electronics/172541\"). A URL keeps its own marketplace and list; a path uses the marketplace and list below. Leave empty for a free format example.", "default": [], "items": { "type": "string" } }, "marketplace": { "title": "Marketplace (for category paths)", "enum": [ "com", "co.uk", "de", "ca", "fr", "it", "es", "com.au", "in", "co.jp", "com.mx", "nl" ], "type": "string", "description": "The Amazon site for categories given as paths. Prices come in that site's currency and titles in its language.", "default": "com" }, "list": { "title": "List (for category paths)", "enum": [ "bestsellers", "new-releases" ], "type": "string", "description": "Best Sellers (Amazon's top sellers, updated hourly) or New Releases (best-selling new and upcoming products).", "default": "bestsellers" }, "maxProductsPerCategory": { "title": "Maximum products per category", "minimum": 1, "maximum": 100, "type": "integer", "description": "1-100, the top N by rank. Amazon's lists stop at 100. Each product is one charged result.", "default": 100 }, "subcategoryDepth": { "title": "Subcategory depth", "minimum": 0, "maximum": 2, "type": "integer", "description": "0 = only the categories you give. 1 = also each of their subcategories (Electronics > Headphones). 2 = one level further (Headphones > Earbud Headphones). Every subcategory is its own list of up to 100 products, so this multiplies the cost; cap it with the maximum below.", "default": 0 }, "maxCategories": { "title": "Maximum categories in total", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper limit on the number of lists scraped in one run, counting subcategories found through the depth setting.", "default": 100 } } }, "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 } } } } } } } } } }