{ "openapi": "3.0.1", "info": { "title": "eBay Product Listing Scraper With Seller Feedback", "description": "eBay Product Listing Scraper extracts product listings with seller feedback, including titles, prices, item details, ratings, reviews, seller information, shipping, images, and URLs. Ideal for product research, competitor analysis, price monitoring, and e-commerce intelligence.", "version": "0.1", "x-build-id": "GqHB5ZG2UrWaUVMYd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~ebay-product-listing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-ebay-product-listing-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/api-empire~ebay-product-listing-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-ebay-product-listing-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/api-empire~ebay-product-listing-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-ebay-product-listing-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": { "sourceUrls": { "title": "๐Ÿช eBay Search / Listing URLs", "type": "array", "description": "Paste one or more eBay search or category URLs. Example: https://www.ebay.com/sch/i.html?_nkw=shoe&Brand=Nike", "items": { "type": "string" } }, "urls": { "title": "๐Ÿ”— eBay Search / Listing URLs (legacy)", "type": "array", "description": "Legacy alias of 'sourceUrls', kept for backward compatibility with the base eBay Product Listing Scraper's input shape. Used only when 'sourceUrls' is empty.", "items": { "type": "string" } }, "fetchBuyerFeedback": { "title": "โญ Fetch buyer feedback / reviews", "type": "boolean", "description": "When ON, visits each listing's own product page and collects its buyer feedback/reviews as separate rows in the dataset, linked back to the listing by itemId. Default: off." }, "feedbackRatingFilter": { "title": "๐ŸŽฏ Feedback rating filter", "enum": [ "All", "Positive", "Neutral", "Negative" ], "type": "string", "description": "Only used when 'Fetch buyer feedback / reviews' is ON. Restricts the collected feedback rows to a specific rating type. Default: All." }, "maxFeedbackPerListing": { "title": "๐Ÿ”ข Max feedback rows per listing", "minimum": 0, "type": "integer", "description": "Caps how many buyer feedback rows are collected per listing when 'Fetch buyer feedback / reviews' is ON. Set to 0 for no limit. Default: 10." }, "fetchSellerProfile": { "title": "๐Ÿงพ Fetch seller profile (feedback score)", "type": "boolean", "description": "When ON, looks up each listing's seller profile once per run (deduplicated โ€” the same seller across multiple listings triggers only one lookup) to add sellerFeedbackScore. Default: off." }, "proxyConfiguration": { "title": "๐ŸŒ Proxy Settings", "type": "object", "description": "Optional. Leave default (no proxy) for most runs โ€” the actor automatically escalates through fallback connection options if needed. Set 'useApifyProxy' to true to apply your own proxy configuration on every request from the start." } } }, "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 } } } } } } } } } }