{ "openapi": "3.0.1", "info": { "title": "Amazon Seller Scraper", "description": "Extract public Amazon seller profiles, ratings, feedback and policies by seller ID or URL. Optional public storefront product extraction and Apify Proxy routing are supported. Stops at access restrictions and reports partial or failed runs honestly.", "version": "1.4", "x-build-id": "3UmealeQjhuet8QBr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codingfrontend~amazon-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codingfrontend-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/codingfrontend~amazon-seller-scraper/runs": { "post": { "operationId": "runs-sync-codingfrontend-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/codingfrontend~amazon-seller-scraper/run-sync": { "post": { "operationId": "run-sync-codingfrontend-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": { "mode": { "title": "Input mode", "enum": [ "sellerId", "sellerUrl" ], "type": "string", "description": "Provide seller IDs or exact public seller-profile URLs.", "default": "sellerId" }, "sellerIds": { "title": "Seller IDs", "minItems": 1, "maxItems": 25, "uniqueItems": true, "type": "array", "description": "Amazon seller IDs for the selected marketplace.", "items": { "type": "string", "pattern": "^[A-Za-z0-9]{5,30}$" } }, "sellerUrls": { "title": "Seller profile URLs", "minItems": 1, "maxItems": 25, "uniqueItems": true, "type": "array", "description": "HTTPS /sp seller-profile URLs on the selected marketplace.", "items": { "type": "string", "pattern": "^https://" } }, "country": { "title": "Amazon marketplace", "enum": [ "in", "com", "co.uk", "de", "co.jp", "ca", "com.au", "com.br" ], "type": "string", "description": "Marketplace used to validate and request every profile.", "default": "in" }, "maxItems": { "title": "Maximum sellers", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum seller profiles processed in this bounded run.", "default": 10 }, "maxFeedbackEntries": { "title": "Feedback entries per seller", "minimum": 0, "maximum": 20, "type": "integer", "description": "Maximum visible feedback entries retained from each profile.", "default": 5 }, "scrapeProducts": { "title": "Include storefront products", "type": "boolean", "description": "Request one public storefront result page per seller.", "default": false }, "maxProducts": { "title": "Products per seller", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum complete product cards retained from that storefront page.", "default": 20 }, "requestDelayMs": { "title": "Delay between sellers (ms)", "minimum": 0, "maximum": 3000, "type": "integer", "description": "Optional delay between bounded seller requests.", "default": 0 }, "requestTimeoutMs": { "title": "Request timeout (ms)", "minimum": 5000, "maximum": 45000, "type": "integer", "description": "Timeout applied to each public page request.", "default": 30000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional explicitly requested Apify Proxy settings. Supported keys: useApifyProxy, apifyProxyGroups, apifyProxyCountry. Custom proxy URLs and unsupported options are rejected.", "default": { "useApifyProxy": false } }, "captureSourceEvidence": { "title": "Capture source evidence", "type": "boolean", "description": "Opt-in storage of exact complete response bytes (base64), SHA256, source URL/status and parser settings in SOURCE_EVIDENCE_* KV records. Includes denial and redirect bodies when received under the 5 MB response limit. Defaults to false; raw public pages can contain personal data.", "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 } } } } } } } } } }