{ "openapi": "3.0.1", "info": { "title": "Amazon Bestsellers Scraper - $0.26 per 1,000, No API Key", "description": "The Best Sellers and New Releases pages publish a top 60 each, across 22 marketplaces, and that ranking comes back as a table: rank, ASIN, title, price, rating, review count, image, link and category path. No account. $0.26 per 1,000 products.", "version": "0.1", "x-build-id": "nAHpexRyE6DBFpmWZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~amazon-bestsellers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~amazon-bestsellers-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~amazon-bestsellers-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": "Category URLs", "minItems": 0, "maxItems": 50, "type": "array", "description": "Amazon list URLs copied straight from the site. Both link shapes work - https://www.amazon.com/gp/bestsellers/electronics/ and https://www.amazon.com/Best-Sellers-Electronics-Headphones/zgbs/electronics/172541/ - and so do New Releases (/gp/new-releases/...) and Movers & Shakers (/gp/movers-and-shakers/...) links. The marketplace and the list type are read from the URL itself, so you can mix countries in one run. Up to 50 URLs.", "items": { "type": "string" } }, "categories": { "title": "Category names or slugs", "minItems": 0, "maxItems": 50, "type": "array", "description": "Department names as Amazon writes them in that marketplace's own language (\"Home & Kitchen\", \"Toys & Games\", \"Bücher\"), or the slug from the URL (\"electronics\", \"toys-and-games\", \"books/2\"). Names are resolved against the marketplace's own Best Sellers menu, which is why \"Home & Kitchen\" correctly becomes home-garden and \"Tools & Home Improvement\" becomes hi. Uses the marketplace and list type chosen below. Up to 50.", "items": { "type": "string" } }, "listType": { "title": "Which list", "enum": [ "bestsellers", "new-releases", "movers-and-shakers" ], "type": "string", "description": "Which ranking to read for the entries in \"Category names or slugs\". Category URLs ignore this - they already say which list they are. Note that Amazon returns empty Movers & Shakers lists for most categories; when that happens you get a free diagnostic row, never a charge.", "default": "bestsellers" }, "domain": { "title": "Marketplace", "enum": [ "com", "co.uk", "de", "fr", "it", "es", "nl", "se", "pl", "ie", "com.be", "ca", "com.mx", "com.br", "com.au", "co.jp", "in", "sg", "ae", "sa", "com.tr", "eg" ], "type": "string", "description": "Which Amazon marketplace the entries in \"Category names or slugs\" belong to. The marketplace's own currency and language preference is sent with every request, so prices come back in the local currency instead of being converted for whatever country the request happens to leave from.", "default": "com" }, "maxItemsPerCategory": { "title": "Products per category", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many ranked products to return for each category, counting from rank 1. Amazon renders 30 products per list page and offers two pages, so 60 is the ceiling and also the default. Lower it while you are testing - you pay per product row." }, "proxyUrls": { "title": "Your own proxy servers (optional)", "minItems": 0, "maxItems": 50, "type": "array", "description": "Leave this empty. By default the run rotates a large pool of addresses that cost you nothing per gigabyte. Fill it in only if you specifically want the traffic to leave through proxy servers you already pay for, in the form http://user:pass@host:port.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }