{ "openapi": "3.0.1", "info": { "title": "eBay Product Reviews Scraper with Advanced Filters", "description": "Effortlessly scrape product reviews from eBay with customizable filters for sorting, rating types, and image-only reviews. Fast, reliable, and packed with rich data to power your market insights.", "version": "0.0", "x-build-id": "lh5IEfwu3mkrxRlHT" }, "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", "default": [ "https://www.ebay.com/itm/135713774861", "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 specific listing. eBay Feedback is seller-level, so a single listing often has very few item-specific reviews, or none at all. This is the precise, product-only view.\n\n• ON — every Feedback the seller has received across all their items (this is the full list you see on the seller's Feedback profile page). Use this when you want volume and the listing itself has little or no Feedback. Note: results are the same for any URL belonging to the same seller, and each review may refer to a different item.", "default": false }, "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 } } }, "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 } } } } } } } } } }