{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings Scraper - Sold Prices, Dates & Sellers", "description": "Scrape completed eBay sales by keyword, seller or item link: the price each buyer paid, title, item id, seller and sale period; add exact end time, bids, shipping, condition and item specifics. 13 eBay sites, monitor mode, price summary. $0.99 per 1,000 sales, no start fee, no eBay login.", "version": "0.1", "x-build-id": "KN7qGXbXUwdeXxTNt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/topapi~ebay-sold-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-topapi-ebay-sold-listings-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/topapi~ebay-sold-listings-scraper/runs": { "post": { "operationId": "runs-sync-topapi-ebay-sold-listings-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/topapi~ebay-sold-listings-scraper/run-sync": { "post": { "operationId": "run-sync-topapi-ebay-sold-listings-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": "🔍 Keywords", "type": "array", "description": "What was sold, as you would search it on eBay. One search per keyword, e.g. \"iphone 13\", \"rtx 4080\", \"lego 42115\". Each row says which keyword found it.", "items": { "type": "string" } }, "startUrls": { "title": "eBay URLs", "type": "array", "description": "eBay search URLs (/sch/i.html?_nkw=... - the keyword and filters are read from the URL), seller feedback or /usr/ links, or item links (/itm/...).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sellers": { "title": "Sellers", "type": "array", "description": "eBay usernames whose sales you want, e.g. \"gadget-solutions\". With keywords, only those sellers' sales of each keyword; without, all their recent sales.", "items": { "type": "string" } }, "itemUrls": { "title": "Item links or ids", "type": "array", "description": "What did this listing sell for? Item URLs or ids, e.g. \"https://www.ebay.com/itm/318800612903\" or \"318800612903\". Ended auctions give the final price and end time; multi-quantity listings give each sale.", "items": { "type": "string" } }, "ebaySite": { "title": "eBay site", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.fr", "ebay.it", "ebay.es", "ebay.ca", "ebay.com.au", "ebay.at", "ebay.ch", "ebay.ie", "ebay.nl", "ebay.pl" ], "type": "string", "description": "Which eBay marketplace to read. Prices come in that site's currency.", "default": "ebay.com" }, "categoryId": { "title": "Category id", "type": "string", "description": "eBay category id for the keyword search, e.g. \"9355\" (Cell Phones & Smartphones). Empty or \"0\" = all categories." }, "subcategoryId": { "title": "Subcategory id", "type": "string", "description": "A subcategory id; overrides Category id when set." }, "itemCondition": { "title": "Condition", "enum": [ "any", "new", "used", "open_box", "refurbished", "for_parts" ], "type": "string", "description": "Only sellers listing this condition for the keyword.", "default": "any" }, "conditionId": { "title": "Condition id", "minimum": 1000, "maximum": 7000, "type": "integer", "description": "An exact eBay condition id instead (1000 new, 1500 open box, 2000-2500 refurbished, 3000 used, 7000 for parts)." }, "buyingFormat": { "title": "Buying format", "enum": [ "all", "auction", "buyItNow", "acceptsOffers" ], "type": "string", "description": "Only sellers listing the keyword in this format.", "default": "all" }, "itemLocation": { "title": "Item location", "enum": [ "default", "domestic", "worldwide" ], "type": "string", "description": "Where the listed items are located, as on eBay's search.", "default": "default" }, "aspectFilter": { "title": "Item specifics filter", "type": "object", "description": "eBay aspect filters for the keyword search, e.g. {\"Brand\": \"Apple\", \"Storage Capacity\": \"128 GB\"}. Use the site's language (ebay.de: \"Marke\")." }, "daysToScrape": { "title": "Sold within (days)", "minimum": 0, "maximum": 1825, "type": "integer", "description": "Sales from the last N days. eBay dates a sale as Past month / Past 6 months / Past year, so 30 keeps the past month, 180 adds 6 months, 365 the year, 0 = everything (up to 5 years).", "default": 30 }, "minPrice": { "title": "Min sold price", "minimum": 0, "type": "number", "description": "Drop sales below this price (site currency). Also narrows the keyword search." }, "maxPrice": { "title": "Max sold price", "minimum": 0, "type": "number", "description": "Drop sales above this price (site currency). Also narrows the keyword search." }, "titleMustMatchQuery": { "title": "Title must match the keyword", "type": "boolean", "description": "Keep only sales whose title has every word of the keyword (4+ word keywords allow one miss). Turn off to keep parts and accessories the seller sold too.", "default": true }, "excludeKeywords": { "title": "Exclude words", "type": "array", "description": "Drop sales whose title has any of these words, e.g. \"case\", \"screen\", \"for parts\".", "items": { "type": "string" } }, "excludeSellers": { "title": "Exclude sellers", "type": "array", "description": "eBay usernames whose sales are skipped.", "items": { "type": "string" } }, "dedupeItemIds": { "title": "One row per listing", "type": "boolean", "description": "A multi-quantity listing can sell many times; on = only its newest sale. Off = one row per sale (the default).", "default": false }, "includeAutomatedFeedback": { "title": "Include sales with eBay automated feedback", "type": "boolean", "description": "eBay leaves automated feedback when an order completes without buyer feedback. These are real sales; off drops them.", "default": true }, "includeItemDetails": { "title": "Item details (exact end time, bids, shipping, specifics)", "type": "boolean", "description": "Open each sold listing's page for its exact end time (single-quantity listings), final bids, format, shipping, condition, location, category and item specifics. Charged as item-details per row that gets them.", "default": false }, "includeDescription": { "title": "Seller description text", "type": "boolean", "description": "With item details on, also read the seller's description (first 5,000 characters). No extra charge.", "default": false }, "monitorMode": { "title": "Only new sales (monitor mode)", "type": "boolean", "description": "Deliver only sales earlier runs did not deliver, per search. Pairs with a daily schedule. Also re-reads auctions it saw ending, for their exact final price.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that remembers delivered sales. Use a different name per schedule.", "default": "ebay-sold-listings-monitor" }, "trackEndingAuctions": { "title": "Track ending auctions", "type": "boolean", "description": "In monitor mode, remember auctions with bids that end within 24 hours and deliver their final price on the next run.", "default": true }, "resetMonitorState": { "title": "Reset monitor memory", "type": "boolean", "description": "Forget what earlier runs delivered for these searches (the next run delivers everything again).", "default": false }, "maxItems": { "title": "Max sold listings", "minimum": 0, "type": "integer", "description": "Most rows this run delivers, across all searches. 0 = no limit (the run ends when the sellers' sales run out, at your spending limit or at the run timeout).", "default": 100 }, "maxItemsPerSearch": { "title": "Max per search", "minimum": 0, "type": "integer", "description": "Most rows per keyword, seller or item. 0 = no per-search limit." }, "maxSellersPerSearch": { "title": "Sellers per keyword", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many of the sellers listing the keyword to read, most listings first. More sellers = more sales, slower run.", "default": 20 }, "maxRowsPerSeller": { "title": "Max sales per seller", "minimum": 0, "type": "integer", "description": "Most sales taken from one seller per search, so one big seller does not fill the run. 0 = no limit.", "default": 50 }, "includeSummary": { "title": "Price summary", "type": "boolean", "description": "Write count, min, median, percentiles and max of the sold prices per search to the SUMMARY record. Free.", "default": true }, "compact": { "title": "Compact rows", "type": "boolean", "description": "Core fields only (18), sized for AI agents and MCP.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Default: Apify datacenter sessions first, residential in the site's country next. Choose groups here to use your own instead.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Parallel sessions", "minimum": 1, "maximum": 4, "type": "integer", "description": "Seller pages read at the same time (each on its own paced session). 2 is the measured sweet spot; more draws eBay's human check sooner.", "default": 2 } } }, "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 } } } } } } } } } }