{ "openapi": "3.0.1", "info": { "title": "Amazon Best Sellers Scraper: Top 100 Rank & Price", "description": "Amazon Best Sellers scraper for any category or subcategory. Get the top 100 rank list with ASIN, title, price, rating, reviews and image, plus New Releases, optional subcategory crawl and delivery ZIP (no extra fee). $1 per 1,000 results. Export or use the API.", "version": "0.1", "x-build-id": "TVPjTULpSDAt37zxK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jaaylee~amazon-bestsellers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jaaylee-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/jaaylee~amazon-bestsellers-scraper/runs": { "post": { "operationId": "runs-sync-jaaylee-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/jaaylee~amazon-bestsellers-scraper/run-sync": { "post": { "operationId": "run-sync-jaaylee-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", "required": [ "categories" ], "properties": { "categories": { "title": "Categories (URLs or slugs)", "type": "array", "description": "Amazon.com Best Sellers or New Releases category URLs (e.g. https://www.amazon.com/gp/bestsellers/electronics/172541) or category slugs (e.g. electronics, kitchen, beauty, toys-and-games). One per line.", "items": { "type": "string" } }, "listType": { "title": "List for slugs", "enum": [ "bestsellers", "new-releases" ], "type": "string", "description": "Which list to use for category slugs. Full URLs keep their own list type.", "default": "bestsellers" }, "maxItemsPerCategory": { "title": "Top N per category", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many ranks to return per category (Amazon lists the top 100).", "default": 100 }, "includeSubcategories": { "title": "Also scrape subcategories", "type": "boolean", "description": "Also scrape the direct subcategories of each category (one level down). Each subcategory returns its own top list.", "default": false }, "zipCode": { "title": "Delivery ZIP code (US)", "pattern": "^\\d{5}(-\\d{4})?$", "type": "string", "description": "Optional. Prices are shown as a shopper in this US ZIP code sees them. Included at no extra cost." }, "maxItems": { "title": "Max results in total", "minimum": 1, "type": "integer", "description": "Optional. Stop after this many results across all categories (useful to cap cost)." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many list pages are fetched in parallel.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Primary proxy. The default Apify datacenter proxy works for most list pages.", "default": { "useApifyProxy": true } }, "residentialFallback": { "title": "Retry blocked pages with residential proxy", "type": "boolean", "description": "If a page stays blocked after 3 attempts on the primary proxy, retry it up to 2 more times through US residential proxies. Blocked pages are never charged either way.", "default": true }, "failOnLowQuality": { "title": "Fail run on low data quality (monitoring)", "type": "boolean", "description": "For monitoring tasks: mark the run as failed when fewer than 80% of pages succeed or key fields are missing.", "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 } } } } } } } } } }