{ "openapi": "3.0.1", "info": { "title": "Amazon ASIN Collector", "description": "Build one clean, deduplicated list of Amazon ASINs from many places at once — search terms, Best Seller charts, seller storefronts and any Amazon listing link. Every ASIN says which source found it, caps keep the run bounded, and full product details can be attached on demand.", "version": "0.0", "x-build-id": "PAUjD2ij61qpqV9RQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~amazon-asin-collector/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-amazon-asin-collector", "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/apt_marble~amazon-asin-collector/runs": { "post": { "operationId": "runs-sync-apt_marble-amazon-asin-collector", "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/apt_marble~amazon-asin-collector/run-sync": { "post": { "operationId": "run-sync-apt_marble-amazon-asin-collector", "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": { "keywords": { "title": "Search keywords", "type": "array", "description": "Collect ASINs from the results of these searches.", "items": { "type": "string" } }, "categories": { "title": "Best Seller categories", "type": "array", "description": "Collect ASINs from these Best Sellers charts.", "items": { "type": "string", "enum": [ "electronics", "books", "home-garden", "kitchen", "toys-and-games", "beauty", "hpc", "sporting-goods", "office-products", "pet-supplies", "automotive", "hi", "videogames", "grocery", "baby-products", "appliances", "musical-instruments", "industrial", "fashion", "movies-tv", "lawn-garden", "pc", "wireless" ], "enumTitles": [ "Electronics", "Books", "Home & Kitchen", "Kitchen", "Toys & Games", "Beauty", "Health & Personal Care", "Sports & Outdoors", "Office Products", "Pet Supplies", "Automotive", "Tools & Home Improvement", "Video Games", "Grocery", "Baby", "Appliances", "Musical Instruments", "Industrial & Scientific", "Clothing, Shoes & Jewelry", "Movies & TV", "Patio, Lawn & Garden", "Computers & Accessories", "Cell Phones & Accessories" ] } }, "sellerIds": { "title": "Seller storefronts", "type": "array", "description": "Collect ASINs from these sellers' catalogues. Storefront links or bare seller IDs.", "items": { "type": "string" } }, "urls": { "title": "Any Amazon listing links", "type": "array", "description": "Collect ASINs from any other Amazon search, category or chart links.", "items": { "type": "string" } }, "maxAsinsPerSource": { "title": "Maximum ASINs per source", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many ASINs from each individual source.", "default": 100 }, "maxTotalAsins": { "title": "Maximum ASINs in total", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop the whole run once this many unique ASINs have been collected.", "default": 2000 }, "includeBasicData": { "title": "Include title and price", "type": "boolean", "description": "Return the title, price and rating shown alongside each ASIN in the listing it came from. Free — this is already on the page.", "default": true }, "includeProductDetails": { "title": "Include full product details", "type": "boolean", "description": "Open each collected ASIN to collect the complete product record — full specifications, every image, the full rating breakdown and category rankings. Much slower and billed separately; leave off for a fast list.", "default": false }, "marketplace": { "title": "Amazon marketplace", "enum": [ "us", "uk", "de", "fr", "es", "it", "ca", "au", "jp", "in", "mx", "br", "nl", "se", "pl", "ae", "sa", "sg", "tr", "eg", "be", "ie" ], "type": "string", "description": "Which country's Amazon site to read. Prices, availability and rankings differ between marketplaces, and results come back in that marketplace's own currency.", "default": "us" }, "maxConcurrency": { "title": "Parallel targets", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many targets to work on at the same time. Higher is faster but Amazon serves fewer complete pages when pushed hard. Leave at 4 unless you have a reason.", "default": 4 } } }, "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 } } } } } } } } } }