{ "openapi": "3.0.1", "info": { "title": "Amazon Best Sellers Scraper: Top 100, Prices & Ratings", "description": "Top 100 products of any Amazon Best Sellers or New Releases list on 21 Amazon sites: rank, ASIN, title, price, stars, ratings count, author and format for books, offers, image. Subcategories too. No login.", "version": "1.0", "x-build-id": "EyXpniuOl6AgjaLUm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serenido~amazon-best-sellers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serenido-amazon-best-sellers", "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/serenido~amazon-best-sellers/runs": { "post": { "operationId": "runs-sync-serenido-amazon-best-sellers", "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/serenido~amazon-best-sellers/run-sync": { "post": { "operationId": "run-sync-serenido-amazon-best-sellers", "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": { "startUrls": { "title": "Amazon list links", "type": "array", "description": "One per line. Any Amazon Best Sellers, New Releases, Movers & Shakers, Most Wished For or Gift Ideas link, from any of the 21 supported Amazon sites, for a department or a subcategory. Examples: https://www.amazon.com/gp/bestsellers/kitchen, https://www.amazon.co.uk/gp/new-releases/books, https://www.amazon.com/Best-Sellers-Kitchen-Dining-Bakeware/zgbs/kitchen/289668. The link https://www.amazon.com/gp/bestsellers (all departments) loads every department's list.", "items": { "type": "string" } }, "categories": { "title": "Or category names", "type": "array", "description": "Instead of links: a department as Amazon writes it in its links (kitchen, electronics, books, toys-and-games, beauty...) or department/number for a subcategory (kitchen/289668). Uses the Amazon site and list chosen below.", "items": { "type": "string" } }, "marketplace": { "title": "Amazon site for category names", "enum": [ "US", "GB", "DE", "FR", "IT", "ES", "NL", "BE", "SE", "PL", "TR", "CA", "MX", "BR", "JP", "IN", "AU", "SG", "AE", "SA", "EG" ], "type": "string", "description": "Only used for category names. Links keep their own Amazon site.", "default": "US" }, "listType": { "title": "List for category names", "enum": [ "bestsellers", "new-releases", "movers-and-shakers", "most-wished-for", "most-gifted" ], "type": "string", "description": "Only used for category names. Links keep their own list.", "default": "bestsellers" }, "maxItemsPerCategory": { "title": "Products per list", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many ranked products to save from each list. Amazon shows up to 100.", "default": 100 }, "subcategoryDepth": { "title": "Subcategory levels", "minimum": 0, "maximum": 3, "type": "integer", "description": "0 = only the lists you give. 1 = also every subcategory one level down (Kitchen & Dining -> Bakeware, Cookware...). 2 or 3 = deeper. Each subcategory is its own top 100.", "default": 0 }, "maxCategories": { "title": "Max lists", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop adding lists (departments and subcategories) after this many.", "default": 200 }, "maxItems": { "title": "Max products in total", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many products in the whole run.", "default": 100000 }, "maxConcurrency": { "title": "Parallel lists", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many lists load at the same time.", "default": 5 }, "proxy": { "title": "Proxy", "type": "object", "description": "Keep the default: amazon.com uses datacenter IPs, other Amazon sites use residential IPs of their own country, so prices come in the local currency. Your own proxy URLs are used for every site if you add them." } } }, "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 } } } } } } } } } }