{ "openapi": "3.0.1", "info": { "title": "Ebuyer Scraper", "description": "Scrape ebuyer.com - the UK technology retailer - for laptops, PC components, monitors, peripherals, networking and more. Search by keyword, browse by category or brand, or fetch product pages by URL, with prices, was-prices, EAN/MPN, specs, ratings, stock status and image galleries.", "version": "1.0", "x-build-id": "mRmd7KAD5kCBi84YA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~ebuyer-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-ebuyer-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/crawlerbros~ebuyer-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-ebuyer-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/crawlerbros~ebuyer-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-ebuyer-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "browseByCategory", "browseByBrand", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text keyword (mode=search). Matches product names, brands, and categories." }, "category": { "title": "Category", "enum": [ "Laptops", "Gaming Laptops", "Desktop PC", "Gaming PC", "Computer Monitors", "Gaming Monitors", "Graphics Cards", "Processors", "Motherboards", "Memory - PC", "Memory - Laptop", "SSDs", "Internal Hard Drives", "External Hard Drives", "Network Attached Storage", "Computer Cases", "Cases", "Power Supplies", "CPU Coolers", "Keyboards", "Mice", "Keyboard and Mouse Sets", "Mouse Mats", "Headsets", "Over-ear Headphones", "In-ear Headphones", "Headphones", "Earphones", "Speakers", "Microphones", "Routers", "Consumer Networking", "Printers", "Televisions", "Projectors", "VR", "Smart Watches", "iPads", "iPhones", "Mobile Phones", "Home Security Cameras", "Cables", "Charging and Cables", "Gaming Chairs", "Desks", "Office Chairs", "Smart Lighting", "Smart Bulbs", "Batteries", "Laptop Bags" ], "type": "string", "description": "Curated product category (mode=browseByCategory; optional filter for mode=search)." }, "brand": { "title": "Brand", "enum": [ "Apple", "ASUS", "MSI", "Samsung", "LG", "HP", "Dell", "Lenovo", "Acer", "AOC", "iiyama", "BenQ", "Western Digital", "Seagate", "SanDisk", "Kingston Technology", "Kingston FURY", "Crucial Technology", "Lexar", "Verbatim", "OWC", "Logitech", "Razer", "SteelSeries", "Turtle Beach", "Trust", "Edifier", "Subsonic", "Canon", "Epson", "Philips", "TCL", "TP-Link", "Netgear", "GOVEE", "Ring", "DJI", "Polaroid", "Microsoft", "Nintendo", "PlayStation", "Xbox", "Intel", "AMD", "Medion", "Corsair", "Sony", "Bosch", "PALIT" ], "type": "string", "description": "Curated top brands (mode=browseByBrand; optional filter for mode=search)." }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Ebuyer product page URLs (mode=byUrl), e.g. https://www.ebuyer.com/asus-asus-dual-geforce-rtx-5060-ti-8gb-gddr7-oc-edition-705966", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (GBP)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only products priced at or above this amount (GBP).", "default": 0 }, "maxPrice": { "title": "Maximum price (GBP)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only products priced at or below this amount (GBP).", "default": 0 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only products with an average customer rating at or above this value (0-5).", "default": 0 }, "containsKeyword": { "title": "Must contain keyword", "type": "string", "description": "Only products whose name contains this substring (case-insensitive)." }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Only include products currently in stock.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc", "newestFirst", "biggestDiscount" ], "type": "string", "description": "Sort order for returned products.", "default": "relevance" }, "fetchProductDetails": { "title": "Fetch full product details", "type": "boolean", "description": "For listing modes: visit each product page to add description, EAN, stock level, and full image gallery. Disable for faster bulk runs.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of product records to return.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Used automatically only if Ebuyer blocks the datacenter IP (403/429). Leave at default.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }