{
"openapi": "3.0.1",
"info": {
"title": "eBay Scraper – Listings, Sold Prices & Sellers (15 Sites)",
"description": "Scrape eBay listings from 15 sites with every filter or any eBay URL: item specifics, EAN, photos, seller profiles with buyer feedback and sale prices, EAN lookup, monitoring of new listings, price drops and final prices of ended auctions.",
"version": "1.0",
"x-build-id": "x6GuobwFuZjQZgCo0"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/liveclaude~ebay-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-liveclaude-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/liveclaude~ebay-scraper/runs": {
"post": {
"operationId": "runs-sync-liveclaude-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/liveclaude~ebay-scraper/run-sync": {
"post": {
"operationId": "run-sync-liveclaude-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": {
"searchQueries": {
"title": "🔎 Search queries",
"type": "array",
"description": "Keywords, one per line. Each query runs on every selected eBay site. 🇵🇱 Frazy do wyszukania, jedna w linii.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 eBay URLs",
"type": "array",
"description": "Paste any eBay link: a search with filters set on the website, a category (/b/...), a listing (/itm/...), a seller (/usr/...) or a store (/str/...). Every website filter works. 🇵🇱 Dowolny link z eBay: wyszukiwanie z filtrami, kategoria, aukcja, sprzedawca lub sklep.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"eans": {
"title": "🏷️ EAN / UPC / ISBN codes",
"type": "array",
"description": "Find every listing of a product by its barcode (searches titles and descriptions). 🇵🇱 Szukaj ofert po kodzie EAN/UPC/ISBN.",
"items": {
"type": "string"
}
},
"sellers": {
"title": "👤 Sellers",
"type": "array",
"description": "eBay usernames (or profile/store URLs). Get the seller profile, all active listings and their buyer feedback with sale prices. 🇵🇱 Nazwy sprzedawców: profil, aktywne oferty i oceny kupujących z cenami sprzedaży.",
"items": {
"type": "string"
}
},
"sites": {
"title": "🌍 eBay sites",
"type": "array",
"description": "Which eBay marketplaces to search. 🇵🇱 Rynki eBay do przeszukania.",
"items": {
"type": "string",
"enum": [
"us",
"uk",
"de",
"fr",
"it",
"es",
"at",
"ch",
"nl",
"be",
"ie",
"pl",
"ca",
"au",
"sg"
],
"enumTitles": [
"🇺🇸 United States (ebay.com)",
"🇬🇧 United Kingdom (ebay.co.uk)",
"🇩🇪 Germany (ebay.de)",
"🇫🇷 France (ebay.fr)",
"🇮🇹 Italy (ebay.it)",
"🇪🇸 Spain (ebay.es)",
"🇦🇹 Austria (ebay.at)",
"🇨🇭 Switzerland (ebay.ch)",
"🇳🇱 Netherlands (ebay.nl)",
"🇧🇪 Belgium (ebay.be)",
"🇮🇪 Ireland (ebay.ie)",
"🇵🇱 Poland (ebay.pl)",
"🇨🇦 Canada (ebay.ca)",
"🇦🇺 Australia (ebay.com.au)",
"🇸🇬 Singapore (ebay.com.sg)"
]
},
"default": [
"us"
]
},
"allSites": {
"title": "All 15 eBay sites",
"type": "boolean",
"description": "Search every supported eBay site at once. 🇵🇱 Wszystkie 15 rynków naraz.",
"default": false
},
"maxItemsPerSearch": {
"title": "Max listings per search",
"minimum": 0,
"type": "integer",
"description": "Per query and site. 0 = everything (large searches are split into price ranges automatically). 🇵🇱 Limit na frazę i rynek, 0 = wszystko.",
"default": 200
},
"sortBy": {
"title": "Sort by",
"enum": [
"best_match",
"newly_listed",
"ending_soonest",
"price_low",
"price_high",
"distance"
],
"type": "string",
"description": "🇵🇱 Sortowanie.",
"default": "best_match"
},
"categoryId": {
"title": "Category ID",
"type": "string",
"description": "eBay category ID, e.g. 9355 (cell phones). Easiest: open the category on eBay and paste the URL above. 🇵🇱 ID kategorii eBay."
},
"priceMin": {
"title": "Min price",
"type": "number",
"description": "In the currency of each site. 🇵🇱 Cena minimalna (waluta danego rynku)."
},
"priceMax": {
"title": "Max price",
"type": "number",
"description": "🇵🇱 Cena maksymalna."
},
"conditions": {
"title": "Condition",
"type": "array",
"description": "🇵🇱 Stan przedmiotu.",
"items": {
"type": "string",
"enum": [
"new",
"open_box",
"refurbished",
"used",
"for_parts"
],
"enumTitles": [
"New",
"Open box",
"Refurbished",
"Used",
"For parts / not working"
]
}
},
"buyingFormat": {
"title": "Buying format",
"enum": [
"all",
"auction",
"buy_it_now"
],
"type": "string",
"description": "🇵🇱 Licytacja, Kup teraz albo wszystko.",
"default": "all"
},
"bestOfferOnly": {
"title": "Accepts offers only",
"type": "boolean",
"description": "🇵🇱 Tylko oferty z propozycją ceny.",
"default": false
},
"freeShippingOnly": {
"title": "Free shipping only",
"type": "boolean",
"description": "🇵🇱 Tylko darmowa wysyłka.",
"default": false
},
"itemLocation": {
"title": "Item location",
"enum": [
"all",
"domestic",
"worldwide"
],
"type": "string",
"description": "🇵🇱 Lokalizacja przedmiotu.",
"default": "all"
},
"searchInDescription": {
"title": "Search in description too",
"type": "boolean",
"description": "🇵🇱 Szukaj też w opisach.",
"default": false
},
"excludeKeywords": {
"title": "Exclude words in title",
"type": "array",
"description": "Skip listings whose title contains any of these words (e.g. case, broken). Skipped listings are free. 🇵🇱 Pomiń tytuły z tymi słowami (bezpłatnie).",
"items": {
"type": "string"
}
},
"titleMustInclude": {
"title": "Title must contain (any of)",
"type": "array",
"description": "🇵🇱 Tytuł musi zawierać jedno z tych słów.",
"items": {
"type": "string"
}
},
"sellerType": {
"title": "Seller type",
"enum": [
"all",
"private",
"business"
],
"type": "string",
"description": "Where eBay shows it (e.g. ebay.de, ebay.co.uk). 🇵🇱 Prywatny / firma.",
"default": "all"
},
"minSellerFeedback": {
"title": "Min seller feedback score",
"type": "integer",
"description": "🇵🇱 Minimalna liczba ocen sprzedawcy."
},
"includeDetails": {
"title": "➕ Listing details",
"type": "boolean",
"description": "Open every listing and add: item specifics (brand, model, EAN/UPC, MPN…), all photos, watchers, quantity sold/available, seller feedback, item location, shipping & returns, start/end date, category path. 🇵🇱 Szczegóły oferty: parametry, EAN, wszystkie zdjęcia, obserwujący, sprzedane sztuki, sprzedawca, lokalizacja, wysyłka.",
"default": false
},
"includeDescription": {
"title": "➕ Seller's description",
"type": "boolean",
"description": "Also download the full item description written by the seller (needs Listing details). 🇵🇱 Pełny opis sprzedawcy.",
"default": false
},
"sellerListings": {
"title": "Sellers: active listings",
"type": "boolean",
"description": "For sellers / store URLs, return all their active listings. 🇵🇱 Aktywne oferty sprzedawcy.",
"default": true
},
"sellerProfile": {
"title": "Sellers: profile",
"type": "boolean",
"description": "Feedback score, % positive, items sold, followers, location, member since, 12-month positive/neutral/negative ratings. 🇵🇱 Profil sprzedawcy.",
"default": true
},
"sellerFeedback": {
"title": "Sellers: buyer feedback (max per seller)",
"minimum": 0,
"type": "integer",
"description": "Latest buyer feedback with the item, the price paid and the date - i.e. the seller's recent sales. 0 = off. 🇵🇱 Oceny kupujących z ceną zakupu = ostatnie sprzedaże sprzedawcy.",
"default": 0
},
"priceSummary": {
"title": "📊 Price summary per search",
"type": "boolean",
"description": "Adds one summary row per search: min / median / average / max price, auctions vs Buy It Now. 🇵🇱 Podsumowanie cen dla każdego wyszukiwania.",
"default": true
},
"compareSites": {
"title": "🌍 Compare prices between eBay sites",
"type": "boolean",
"description": "For queries searched on 2+ sites: median price per site in USD and the cheapest site. 🇵🇱 Porównanie cen między rynkami.",
"default": false
},
"onlyNewItems": {
"title": "🔔 Only new listings (monitoring)",
"type": "boolean",
"description": "Remember listings and on next runs return (and charge) only new ones - perfect for scheduled deal alerts. 🇵🇱 Monitoring: kolejne uruchomienia zwracają tylko nowe oferty.",
"default": false
},
"trackPriceDrops": {
"title": "Also return price drops",
"type": "boolean",
"description": "🇵🇱 Zwracaj też obniżki cen.",
"default": true
},
"detectSoldItems": {
"title": "Track final prices of ended listings",
"type": "boolean",
"description": "When a tracked listing ends, its public page is checked: final price, sold or not, bids, days on market. eBay hides sold searches from signed-out users since July 2026 - this is how you still get real selling prices for your searches. 🇵🇱 Gdy śledzona oferta się kończy: cena końcowa, czy sprzedana, liczba ofert, dni wystawienia.",
"default": true
},
"emitOnFirstRun": {
"title": "Return current listings on the first run",
"type": "boolean",
"description": "Off = the first run only saves a baseline. 🇵🇱 Wyłączone = pierwsze uruchomienie tylko zapamiętuje stan.",
"default": true
},
"monitorId": {
"title": "Monitor name",
"type": "string",
"description": "Optional name for this monitor's memory. 🇵🇱 Opcjonalna nazwa monitora."
},
"bypassResultLimit": {
"title": "Go past eBay's 10,000 result limit",
"type": "boolean",
"description": "🇵🇱 Omijanie limitu 10 000 wyników.",
"default": true
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 60,
"type": "integer",
"description": "🇵🇱 Równoległe zapytania.",
"default": 25
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}