{ "openapi": "3.0.1", "info": { "title": "Amazon Seller Scraper", "description": "The Amazon Seller Data Extractor Scraper efficiently collects key seller information from Amazon, including store name, ratings, feedback, and product listings. Ideal for market research, competitor analysis, and eCommerce intelligence, it delivers accurate, structured data ready for API or export.", "version": "0.1", "x-build-id": "YdMajW1rufwQ73viE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~amazon-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-amazon-seller-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/scraper-engine~amazon-seller-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-amazon-seller-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/scraper-engine~amazon-seller-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-amazon-seller-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": { "asinInputs": { "title": "Enter Amazon ASINs", "type": "array", "description": "List of Amazon ASINs (e.g., B00P8XQPY4). The actor will extract seller information from product pages.", "items": { "type": "string" } }, "usernameInputs": { "title": "Enter Seller Usernames", "type": "array", "description": "List of Amazon seller usernames or seller IDs (e.g., A33W53J5GVPZ8K).", "items": { "type": "string" } }, "keywordInputs": { "title": "Enter Keywords", "type": "array", "description": "List of keywords to search for sellers (e.g., 'electronics seller', 'bookstore').", "items": { "type": "string" } }, "startUrls": { "title": "Amazon Seller URLs", "type": "array", "description": "List of Amazon seller page URLs (e.g., https://www.amazon.com/sp?seller=A33W53J5GVPZ8K).", "items": { "type": "string" } }, "amazonDomain": { "title": "Amazon domain", "type": "string", "description": "Amazon domain to use (e.g., amazon.com, amazon.co.uk, amazon.de).", "default": "amazon.com" }, "language": { "title": "Language", "type": "string", "description": "Language for Amazon pages (e.g., en-US, en-GB, de-DE). Leave empty for default.", "default": "" }, "proxyCountry": { "title": "Proxy country", "type": "string", "description": "Country for proxy selection. Use 'AUTO' for automatic selection.", "default": "AUTO" }, "useCaptchaSolver": { "title": "Use Captcha solver", "type": "boolean", "description": "Enable captcha solver (warning: may incur additional costs).", "default": false }, "sortOrder": { "title": "Review sort order", "enum": [ "recent", "helpful", "rating" ], "type": "string", "description": "Sort order for feedbacks (if applicable). Options: 'recent', 'helpful', 'rating'", "default": "recent" }, "maxComments": { "title": "Maximum reviews per product", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of feedback comments to extract per seller (0 = all available).", "default": 10 }, "maxConcurrency": { "title": "Maximum concurrent requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of seller/product pages fetched in parallel. Lower values are safer for avoiding blocks and instability on Amazon.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Note: This actor always uses residential proxy regardless of your selection. The proxy configuration option is available for compatibility but will be automatically overridden to use residential proxy." } } }, "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 } } } } } } } } } }