{ "openapi": "3.0.1", "info": { "title": "eBay UK Products Scraper", "description": "Scrapes **eBay UK** product listings by keyword search and/or category. Returns raw listing data including title, price, condition, shipping, seller info, and more. Uses HTTP requests with Cheerio for fast, efficient scraping.", "version": "1.0", "x-build-id": "YqrCS0KSUEJU3hzVP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_ops_main~ebay-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_ops_main-ebay-uk-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/data_ops_main~ebay-uk-scraper/runs": { "post": { "operationId": "runs-sync-data_ops_main-ebay-uk-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/data_ops_main~ebay-uk-scraper/run-sync": { "post": { "operationId": "run-sync-data_ops_main-ebay-uk-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": { "keywords": { "title": "Search Keywords", "type": "array", "description": "List of keywords to search for on eBay UK. At least one keyword or a categoryId must be provided.", "default": [], "items": { "type": "string" } }, "categoryId": { "title": "Category ID", "type": "integer", "description": "eBay UK category ID to browse. Common IDs: 293 (Electronics), 15032 (Mobile Phones), 177 (Laptops), 1249 (Video Games), 1059 (Men's Clothing), 15724 (Women's Clothing), 63889 (Shoes), 220 (Toys), 888 (Sporting Goods). Can be combined with keywords for filtered search." }, "pages": { "title": "Pages per Keyword", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of search result pages to scrape per keyword.", "default": 1 }, "sortOrder": { "title": "Sort Order", "enum": [ "best_match", "ending_soonest", "newly_listed", "price_asc", "price_desc", "distance_asc" ], "type": "string", "description": "How to sort the search results.", "default": "best_match" }, "minPrice": { "title": "Minimum Price (GBP)", "type": "number", "description": "Filter listings by minimum price in British Pounds." }, "maxPrice": { "title": "Maximum Price (GBP)", "type": "number", "description": "Filter listings by maximum price in British Pounds." }, "buyItNow": { "title": "Buy It Now Only", "type": "boolean", "description": "If enabled, only show Buy It Now listings (excludes auctions).", "default": false }, "freeShipping": { "title": "Free Shipping Only", "type": "boolean", "description": "If enabled, only show listings with free shipping.", "default": false }, "delayMs": { "title": "Delay Between Requests (ms)", "minimum": 500, "maximum": 10000, "type": "integer", "description": "Milliseconds to wait between page requests. Higher values are more polite to eBay servers.", "default": 1200 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings to use for scraping. Recommended to avoid rate limiting by eBay.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }