{ "openapi": "3.0.1", "info": { "title": "eBay Product Reviews Scraper with Advanced Filters", "description": "Scrape eBay reviews (seller feedback) from any listing URL: rating, comment, reviewer, verified purchase, date and buyer photos, plus the reviewed item. Filter positive, neutral or negative, photos only, skip automated feedback, or pull all of a seller's feedback.", "version": "0.0", "x-build-id": "3DYr9BbTbm9Y6z3jO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delicious_zebu~ebay-product-reviews-scraper-with-advanced-filters/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delicious_zebu-ebay-product-reviews-scraper-with-advanced-filters", "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/delicious_zebu~ebay-product-reviews-scraper-with-advanced-filters/runs": { "post": { "operationId": "runs-sync-delicious_zebu-ebay-product-reviews-scraper-with-advanced-filters", "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/delicious_zebu~ebay-product-reviews-scraper-with-advanced-filters/run-sync": { "post": { "operationId": "run-sync-delicious_zebu-ebay-product-reviews-scraper-with-advanced-filters", "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": [ "urls" ], "properties": { "urls": { "title": "eBay Product URLs", "uniqueItems": true, "type": "array", "description": "One or more eBay product (listing) URLs to scrape reviews from. Example: https://www.ebay.com/itm/135713774861 or https://www.ebay.co.uk/itm/298189822005", "items": { "type": "string" } }, "scrapeAllSellerReviews": { "title": "Scrape all seller reviews", "type": "boolean", "description": "Controls which reviews are collected for each URL.\n\n• OFF (default): only the Feedback attached to that listing. eBay Feedback is seller-level, so a listing may have few or no item-specific reviews.\n\n• ON: all Feedback the seller has received across their items, as on the seller's Feedback page. Use it when you want volume. Results are the same for any URL from the same seller, and each review may refer to a different item.", "default": false }, "excludeAutomatedFeedback": { "title": "Exclude eBay automated Feedback", "type": "boolean", "description": "eBay auto-generates template Feedback such as \"Order delivered on time with no issues\" on behalf of buyers who never wrote anything. In our measurements these accounted for about 57% of all results, they are identical to each other, and they carry no opinion about the product.\n\n• ON (default) — only real, buyer-written Feedback is returned.\n\n• OFF — return everything eBay shows, including the automated entries.", "default": true }, "Sort_by": { "title": "Sort reviews by", "enum": [ "TIME", "RELEVANCE" ], "type": "string", "description": "How to order the reviews. TIME = most recent (recommended, returns the cleanest, most complete results). RELEVANCE = most relevant (eBay may return fewer/none for item-level scope).", "default": "TIME" }, "Rating_type": { "title": "Rating type", "enum": [ "All ratings", "POSITIVE", "NEUTRAL", "NEGATIVE" ], "type": "string", "description": "Keep only reviews with this Feedback rating. Choose 'All ratings' to apply no rating filter.", "default": "All ratings" }, "With_photos_only": { "title": "With photos only", "type": "boolean", "description": "If enabled, only return reviews that include buyer photos.", "default": false }, "max_reviews": { "title": "Max reviews per URL", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to scrape per URL. Set 0 (or leave unset) for unlimited.", "default": 0 } } }, "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 } } } } } } } } } }