{ "openapi": "3.0.1", "info": { "title": "Amazon Seller + Feedback Scraper", "description": "Scrape Amazon Seller profiles or Seller feedback. Pick one option per run, paste a seller ID or seller page URL, then download the results with the run Export button (JSON, CSV, Excel).for brand protection, marketplace intelligence, seller due diligence, VOC, 3P competitor research and NLP pipelines", "version": "0.0", "x-build-id": "HbDEqGGEAbZ5AFlLp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wibuild.in~amazon-seller-feedback-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wibuild.in-amazon-seller-feedback-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/wibuild.in~amazon-seller-feedback-scraper/runs": { "post": { "operationId": "runs-sync-wibuild.in-amazon-seller-feedback-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/wibuild.in~amazon-seller-feedback-scraper/run-sync": { "post": { "operationId": "run-sync-wibuild.in-amazon-seller-feedback-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", "required": [ "seller", "scrapeType" ], "properties": { "scrapeType": { "title": "What to collect", "enum": [ "profile", "feedback" ], "type": "string", "description": "One engine per run. Seller profile = one row per seller (name, about, address, ratings, phone when published). Seller feedback = one row per customer comment. To get both, run the actor twice.", "default": "feedback" }, "seller": { "title": "Seller ID or URL", "type": "string", "description": "Amazon seller ID (for example A2YISN0J3GGO3N) or the public seller page URL." }, "sellers": { "title": "More sellers (optional)", "type": "array", "description": "Additional seller IDs or seller page URLs to collect in the same run.", "items": { "type": "string" } }, "domain": { "title": "Marketplace", "enum": [ "com", "co.uk", "de", "fr", "it", "es", "ca", "com.mx", "com.au", "co.jp", "in" ], "type": "string", "description": "Used when the input is a seller ID only. Ignored when the URL already includes a marketplace host.", "default": "com" }, "maxMode": { "title": "Max Mode (maximize unique feedback)", "type": "boolean", "description": "Used only when What to collect is Seller feedback. Ignored for Seller profile. ON = broadest unique comments. OFF = only the time window and star filter below.", "default": true }, "timePeriod": { "title": "Feedback time window (used when Max Mode is OFF)", "enum": [ "30d", "90d", "365d", "Lifetime" ], "type": "string", "description": "Used only for Seller feedback when Max Mode is OFF. Limit comments to the last 30 days, 90 days, 12 months, or Lifetime.", "default": "Lifetime" }, "starRatings": { "title": "Star / sentiment filter (used when Max Mode is OFF)", "type": "array", "description": "Used only for Seller feedback when Max Mode is OFF. Keep all stars, a single star, all positive (4–5), or all critical (1–3).", "items": { "type": "string", "enum": [ "all", "5", "4", "3", "2", "1", "positive", "critical" ], "enumTitles": [ "All stars", "5 star only", "4 star only", "3 star only", "2 star only", "1 star only", "All positive (4–5)", "All critical (1–3)" ] }, "default": [ "all" ] }, "maxFeedback": { "title": "Max feedback", "minimum": 1, "type": "integer", "description": "Used only for Seller feedback. Optional cap on unique comments. Leave empty for no cap. Ignored for Seller profile." } } }, "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 } } } } } } } } } }