{ "openapi": "3.0.1", "info": { "title": "Amazon Seller Data Extractor", "description": "Amazon Seller Data Extractor Scraper collects seller information from Amazon listings. Capture seller names, ratings, feedback counts, prices, inventory signals, and marketplace details. Ideal for research, competitor tracking, and workflows needing structured Amazon seller data.", "version": "0.1", "x-build-id": "yUmDNqW8evmsXItEl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~amazon-seller-data-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-amazon-seller-data-extractor", "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/api-empire~amazon-seller-data-extractor/runs": { "post": { "operationId": "runs-sync-api-empire-amazon-seller-data-extractor", "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/api-empire~amazon-seller-data-extractor/run-sync": { "post": { "operationId": "run-sync-api-empire-amazon-seller-data-extractor", "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": { "asinInputs": { "title": "๐Ÿ“ฆ Amazon ASINs (product codes)", "type": "array", "description": "One ASIN per row (example: B00P8XQPY4). Weโ€™ll open each product page and pull the seller behind the offer ๐Ÿท๏ธโœจ", "items": { "type": "string" } }, "usernameInputs": { "title": "๐Ÿ‘ค Seller usernames / merchant IDs", "type": "array", "description": "Amazon seller IDs like A33W53J5GVPZ8K โ€” perfect when you already know exactly who youโ€™re researching ๐ŸŽฏ", "items": { "type": "string" } }, "keywordInputs": { "title": "๐Ÿ”Ž Keywords (discover sellers)", "type": "array", "description": "Search-style phrases (e.g. โ€œhandmade ceramics UKโ€, โ€œelectronics refurbโ€). Great for prospecting new storefronts ๐Ÿง ๐Ÿ’ก", "items": { "type": "string" } }, "startUrls": { "title": "๐Ÿ”— Direct seller page URLs", "type": "array", "description": "Full Amazon seller profile links (e.g. https://www.amazon.com/sp?seller=โ€ฆ). Paste as many as you need โ€” weโ€™ll follow each one ๐Ÿ”—๐Ÿš€", "items": { "type": "string" } }, "amazonDomain": { "title": "๐ŸŒ Amazon domain", "type": "string", "description": "Examples: amazon.com, amazon.co.uk, amazon.de, amazon.co.jp โ€” pick the storefront your customers actually see ๐Ÿ—บ๏ธ", "default": "amazon.com" }, "language": { "title": "๐Ÿ—ฃ๏ธ Page language (locale)", "type": "string", "description": "Optional locale string (en-US, en-GB, de-DEโ€ฆ). Leave blank to let Amazon decide โ€” totally fine for most runs ๐ŸŽ›๏ธ", "default": "" }, "proxyCountry": { "title": "๐ŸŒŽ Proxy country hint", "type": "string", "description": "ISO-style country for routing (or AUTO โœจ) โ€” helps keep requests feeling local and natural ๐Ÿงญ", "default": "AUTO" }, "useCaptchaSolver": { "title": "๐Ÿค– Use captcha solver", "type": "boolean", "description": "Flip ON if Amazon throws puzzles often โ€” may add platform cost, but can rescue stubborn runs ๐Ÿงฉ๐Ÿ’ณ", "default": false }, "sortOrder": { "title": "โญ Review sort order", "enum": [ "recent", "helpful", "rating" ], "type": "string", "description": "How feedback is ordered when we collect it: freshest, most helpful, or by rating vibe ๐Ÿ“‘", "default": "recent" }, "maxComments": { "title": "๐Ÿ’ฌ Max reviews per seller", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Cap feedback rows per seller (0 = grab everything the page allows โ€” slower but exhaustive ๐Ÿ“š)", "default": 10 }, "maxConcurrency": { "title": "โšก Max parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "Higher = faster ๐ŸŽ๏ธ but hotter on Amazonโ€™s radar. Lower (1โ€“5) = gentler, great for fragile storefronts ๐Ÿข๐Ÿ’š", "default": 10 }, "proxyConfiguration": { "title": "๐Ÿงฉ Proxy configuration (optional)", "type": "object", "description": "๐Ÿ  Heads-up: this actor always runs on residential proxies for reliability. UI choices here stay for compatibility but may be overridden automatically โ€” expand when you need granular proxy JSON ๐Ÿ› ๏ธ๐Ÿ’ก" } } }, "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 } } } } } } } } } }