{ "openapi": "3.0.1", "info": { "title": "Free Amazon Seller Feedback Scraper", "description": "Retrieve individual Amazon seller feedback entries including star rating, comment text, rater name, date, and seller response flag by seller ID or seller URL, with rating and time period filters.", "version": "0.0", "x-build-id": "XvPYD42Xv48xcr6KS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/easyparser~amazon-seller-feedback/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-easyparser-amazon-seller-feedback", "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/easyparser~amazon-seller-feedback/runs": { "post": { "operationId": "runs-sync-easyparser-amazon-seller-feedback", "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/easyparser~amazon-seller-feedback/run-sync": { "post": { "operationId": "run-sync-easyparser-amazon-seller-feedback", "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": [ "domain" ], "properties": { "seller_id": { "title": "Seller ID", "type": "string", "description": "Amazon seller ID to read feedback for. Example: AXCB29L39I26U. You can also use the URL or list fields." }, "url": { "title": "Seller URL (alternative to Seller ID)", "type": "string", "description": "Full Amazon seller profile or storefront URL. Use instead of seller_id if you do not know the seller ID." }, "seller_ids": { "title": "Seller ID List (bulk)", "type": "array", "description": "Optional list of Amazon seller IDs to process in one run, one per line. Can be combined with the single seller ID field.", "items": { "type": "string" } }, "urls": { "title": "Seller URL List (bulk)", "type": "array", "description": "Optional list of Amazon seller profile URLs to process in one run, one per line.", "items": { "type": "string" } }, "domain": { "title": "Amazon Marketplace", "enum": [ ".com", ".co.uk", ".de", ".fr", ".co.jp", ".ca", ".it", ".es", ".com.au", ".com.br", ".com.mx", ".nl", ".se", ".pl", ".sg", ".com.tr", ".ae", ".sa", ".in", ".eg", ".com.be" ], "type": "string", "description": "The Amazon marketplace to query." }, "min_rating": { "title": "Minimum Star Rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return feedback with at least this many stars (1-5).", "default": 1 }, "max_rating": { "title": "Maximum Star Rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return feedback with at most this many stars (1-5). Set to 3 to focus on negative feedback.", "default": 5 }, "history_range": { "title": "Time Period", "enum": [ "1", "3", "12", "all" ], "type": "string", "description": "Only return feedback from this time period.", "default": "all" }, "max_pages": { "title": "Pages per Seller", "minimum": 1, "maximum": 5, "type": "integer", "description": "Number of feedback pages to retrieve per seller. Each page returns about 5 entries and consumes 1 credit. Maximum is 5 pages.", "default": 1 }, "api_key": { "title": "Easyparser API Key (Optional)", "type": "string", "description": "Your personal Easyparser API key for higher request limits. Leave empty to use the shared demo key. Get your own free key at https://app.easyparser.com/signup - 100 free credits/month, no credit card required." } } }, "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 } } } } } } } } } }