{ "openapi": "3.0.1", "info": { "title": "Amazon Bestsellers Scraper - Ranks, Prices & Ratings", "description": "[$1.20 / 1K products] Scrape Amazon Best Sellers, New Releases, Most Wished For and Gift Ideas across 15 marketplaces. Full top 100 with prices, star ratings and review counts. No start fee.", "version": "0.1", "x-build-id": "EpcViR9raebHRp3hJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~amazon-bestsellers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-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/webdata_labs~amazon-bestsellers-scraper/runs": { "post": { "operationId": "runs-sync-webdata_labs-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/webdata_labs~amazon-bestsellers-scraper/run-sync": { "post": { "operationId": "run-sync-webdata_labs-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": "Amazon category URLs", "type": "array", "description": "Paste Best Sellers, New Releases, Most Wished For or Gift Ideas page URLs straight from Amazon. This is the most reliable way to name a category, because category slugs differ on every marketplace.", "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "CA", "JP", "IN", "AU", "MX", "BR", "NL", "SE", "PL" ], "type": "string", "description": "Which Amazon site to use for the category slugs below. Ignored for pasted URLs, which carry their own marketplace.", "default": "US" }, "categorySlugs": { "title": "Category slugs", "type": "array", "description": "Category names as they appear in the URL, e.g. electronics, books, toys-and-games. Slugs are localised: \"electronics\" exists on amazon.com but not on amazon.de. When in doubt paste the URL instead.", "items": { "type": "string" } }, "listTypes": { "title": "Which rankings", "type": "array", "description": "Amazon publishes four ranked lists per category. Movers & Shakers is not available: Amazon renders it in the browser only.", "items": { "type": "string", "enum": [ "bestsellers", "new-releases", "most-wished-for", "most-gifted" ], "enumTitles": [ "Best Sellers", "New Releases", "Most Wished For", "Gift Ideas (Most Gifted)" ] }, "default": [ "bestsellers" ] }, "maxProductsPerList": { "title": "Products per list", "minimum": 1, "maximum": 100, "type": "integer", "description": "Amazon publishes a top 100 per category and list type. Lower this to sample.", "default": 100 }, "includePriceAndRating": { "title": "Include prices and ratings", "type": "boolean", "description": "Amazon serves the complete ranking on one page layout and the prices and star ratings on another, so this fetches both and merges them. Turn it off to halve the requests when you only need the ranking.", "default": true }, "includeSubcategories": { "title": "Also scrape subcategories", "type": "boolean", "description": "Reads the subcategory list off each page and scrapes those rankings too. This is how you cover a whole department rather than just its top level.", "default": false }, "maxSubcategories": { "title": "Max subcategories", "minimum": 0, "maximum": 200, "type": "integer", "description": "Cap on how many subcategories to follow, so a big department cannot run up a bill.", "default": 10 }, "outputCategories": { "title": "Also output the subcategory list", "type": "boolean", "description": "Adds one row per discovered subcategory, with its node ID, so you can feed them back in later.", "default": false } } }, "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 } } } } } } } } } }