{ "openapi": "3.0.1", "info": { "title": "Amazon Best Sellers & New Releases Scraper - Top 100", "description": "Amazon Best Sellers scraper and New Releases scraper: the ranked top 100 of any category on 21 marketplaces, by category name or list URL, with rank, ASIN, title, price, rating and ratings count. Read every subcategory in one run and schedule it to track rank changes. No login, no browser.", "version": "0.1", "x-build-id": "reAjYa8IVoELk8Xye" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lergassy~amazon-bestsellers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lergassy-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/lergassy~amazon-bestsellers-scraper/runs": { "post": { "operationId": "runs-sync-lergassy-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/lergassy~amazon-bestsellers-scraper/run-sync": { "post": { "operationId": "run-sync-lergassy-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": { "categories": { "title": "πŸ—‚οΈ Categories", "type": "array", "description": "Category names as Amazon shows them β€” Home & Kitchen, Electronics > Headphones & Earbuds β€” or slugs and node paths from list URLs β€” kitchen, electronics/172541. One list per line. A name Amazon does not have comes back as a free row listing the names it does have.", "items": { "type": "string" } }, "marketplace": { "title": "🌍 Amazon marketplace", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "NL", "BE", "SE", "PL", "TR", "CA", "MX", "BR", "AU", "JP", "IN", "SG", "AE", "SA", "EG" ], "type": "string", "description": "Used with Categories. Category URLs carry their own marketplace.", "default": "US" }, "listType": { "title": "πŸ† List", "enum": [ "bestsellers", "new_releases" ], "type": "string", "description": "Which Amazon ranking to read for the Categories above.", "default": "bestsellers" }, "maxItemsPerCategory": { "title": "πŸ“¦ Products per list", "minimum": 1, "maximum": 100, "type": "integer", "description": "Amazon ranks the top 100 of each list (two pages of 50).", "default": 50 }, "categoryUrls": { "title": "πŸ”— List URLs", "type": "array", "description": "Paste any Best Sellers or New Releases URL from any Amazon site β€” the list type and marketplace are read from the URL.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeSubcategories": { "title": "🌳 Also read subcategories", "type": "boolean", "description": "Reads the lists of the subcategories shown on each list page (one level down) β€” e.g. Electronics β†’ Headphones, Cameras, Car Electronics…", "default": false }, "maxSubcategories": { "title": "Subcategories per list", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many subcategories to read when the option above is on.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Off by default β€” list pages answer a direct request. A page that comes back as a robot check is retried on another address automatically, residential last.", "default": { "useApifyProxy": 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 } } } } } } } } } }