{ "openapi": "3.0.1", "info": { "title": "Ebay Scraper", "description": "Extract eBay listings at scale — prices, conditions, seller ratings, shipping costs, bids, and item specifics from any eBay marketplace. Search by keyword with filters for condition, price range, and listing type. Retrieve full details with specs, images, brand, and product identifiers.", "version": "1.0", "x-build-id": "dNlv6IEw0hCvK8nNh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~ebay-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-ebay-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/silentflow~ebay-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-ebay-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/silentflow~ebay-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-ebay-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "eBay URLs to scrape directly. Supports search results pages and individual item pages.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searches": { "title": "Search queries", "type": "array", "description": "Keywords to search for on eBay. Each query runs as a separate search.", "items": { "type": "string" } }, "site": { "title": "eBay site", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.fr", "ebay.ca", "ebay.it", "ebay.es", "ebay.com.au" ], "type": "string", "description": "Which eBay marketplace to search.", "default": "ebay.com" }, "sort": { "title": "Sort results by", "enum": [ "best_match", "ending_soon", "price_asc", "price_desc", "newest" ], "type": "string", "description": "How to order search results.", "default": "best_match" }, "condition": { "title": "Condition", "enum": [ "any", "new", "used", "refurbished" ], "type": "string", "description": "Filter listings by item condition.", "default": "any" }, "listingType": { "title": "Listing type", "enum": [ "any", "buy_now", "auction" ], "type": "string", "description": "Filter by listing format.", "default": "any" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Minimum price filter (in the site's local currency). Leave at 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Maximum price filter (in the site's local currency). Leave at 0 for no maximum.", "default": 0 }, "category": { "title": "Category ID", "type": "string", "description": "eBay category ID to search within (e.g., '9355' for Cell Phones). Leave empty for all categories.", "default": "" }, "maxItems": { "title": "Maximum number of items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum total number of listings to save.", "default": 50 }, "includeDetails": { "title": "Scrape item detail pages", "type": "boolean", "description": "Visit each item's page for full data: description, item specifics (Brand, Color, Size...), all images, EAN/UPC/MPN. Slower but returns richer data.", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Configure proxy for scraping. Residential proxies are recommended for best reliability.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }