{ "openapi": "3.0.1", "info": { "title": "Amazon Best Sellers Scraper", "description": "Extract ranked Amazon Best Sellers products with rank, ASIN, title, price, rating, review count, image, and product URL. Filter by rating or price for market research and scheduled trend snapshots. Direct category pages keep runs lightweight.", "version": "0.1", "x-build-id": "hvTHLhddMC4vLJyUs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/schnellscrapers~amazon-best-sellers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-schnellscrapers-amazon-best-sellers-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/schnellscrapers~amazon-best-sellers-scraper/runs": { "post": { "operationId": "runs-sync-schnellscrapers-amazon-best-sellers-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/schnellscrapers~amazon-best-sellers-scraper/run-sync": { "post": { "operationId": "run-sync-schnellscrapers-amazon-best-sellers-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", "required": [ "categoryUrls" ], "properties": { "categoryUrls": { "title": "Best Sellers URLs", "type": "array", "description": "Paste Amazon Best Sellers category URLs such as `https://www.amazon.com/gp/bestsellers/beauty/`. Use one or more URLs from supported Amazon marketplaces.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "Category URL", "description": "An Amazon Best Sellers category page URL." } } } }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many products across all category URLs. Set a small cap for a quick price and rank snapshot.", "default": 100 }, "maxItemsPerCategory": { "title": "Products per category", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum products to emit from each category URL. The first page usually contains about 30 ranked products.", "default": 30 }, "maxPagesPerCategory": { "title": "Pages per category", "minimum": 1, "maximum": 10, "type": "integer", "description": "Follow Amazon's Next page link up to this many pages per category. Each extra page adds another source request.", "default": 1 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep products with this star rating or higher. Use 0 to keep every ranked product.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Keep products at or below this displayed price in the marketplace currency. Use 0 to disable the filter; products without a visible price are excluded when a limit is set.", "default": 0 }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Match filters and validate records without writing dataset items. Logs report selected products and written products.", "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 } } }, "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 } } } } } } } } } }