Recent eBay sold comps
get_sold_compsThe most recent real eBay sales (sold comps) for a search query (brand, model or pattern, a few specific words), with the count, median and quartiles. Use when the user wants to see what actually sold and for how much. It searches the signed-in user's own eBay marketplace (eBay UK in GBP for a UK seller), eBay US in USD when nobody is signed in, or the site given in marketplace; the result names the site (marketplace) and the currency (currency). One search runs: the query as typed (a retail price with "$" in it is left out), with model or part_number appended only when the query does not already name it; with no query, brand plus model, or brand plus part_number. Sales whose title shows a different item are left out of the count, median and quartiles: comps.matched is how many were kept, comps.dropped how many were left out, and comps.relevanceChecked is false when that check could not run (every sale is then kept). comps.countIsLowerBound true means eBay returned a full page, so the count is that many or more. include words must all appear in a sale's title (and are added to the search when missing); a title with any exclude word is left out; both match whole words in any case and are named in the answer. prefer words leave nothing out: sales whose title has every one are listed first (preferred true) and summarized in comps.preferred, while count and summary still cover every matching sale. Each listed sale has condition, saleType, bids, shipping and location, each null when not known (a sale stored before 22 October 2026 gives condition only as new or used). exclude_items leaves out sales by eBay item number (each listed sale's itemId), before every other filter; comps.removedByItems counts them. limit sets how many recent sales are listed (default 8, up to 50).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | No | The brand or maker exactly as printed on the item, its tag or its label (for example "Simrad", "Pyrex", "Levi's"). Fill it from what you read on the item or the user's photo; leave it empty rather than guess. | |
| limit | No | How many recent sales to list in comps.recent, 1 to 50. Leave it empty for 8. The count and summary always cover every matching sale, not just the ones listed. | |
| model | No | The model or product-line name as printed on the item or its box (for example "iPhone 12", "QuietComfort 35", "Odyssey G5", "501"). It is passed to the identification as a hint and added to the search when no word of it is already there; it never replaces the search. Put a manufacturer part number in part_number. Leave it empty rather than guess. | |
| query | No | 3 to 6 specific words, brand and model first, like an eBay search. | |
| prefer | No | Up to 5 soft words (each up to 40 characters), for example ["rattan"]. No sale is left out and the search is not changed: sales whose title contains every one as a whole word, any case, are listed first in comps.recent (marked preferred) and summarized apart in comps.preferred. Use prefer when sellers may word the same item differently; use include to keep only titles with the word. | |
| exclude | No | Up to 5 words (each up to 40 characters); a sale whose title contains any of them as a whole word, any case, is left out, for example ["jade", "cabinet"]. | |
| include | No | Up to 5 words (each up to 40 characters) every sale title must contain as a whole word, any case, for example ["oak", "carved"]. They are also added to the search when the query does not already hold them. | |
| marketplace | No | The eBay site to search: EBAY_US (eBay US, prices in USD) or EBAY_GB (eBay UK, prices in GBP). Leave it empty to use the signed-in user's own marketplace, or eBay US when nobody is signed in. Set it only when the user asks about a market other than their own. A photo scan always uses the account's own marketplace. | |
| part_number | No | The manufacturer part number printed on the label or rating plate (for example "000-16294-001", "DCD771C2", "CUH-ZCT2U"), copied character for character. Not a size, voltage, year, SKU, ASIN, LPN or barcode. In price_item it is a hint to the identification only and is not added to the search (a part number required in every listing title leaves too few sales); in get_sold_comps it is appended to the query when the query lacks it. Leave it empty rather than guess. | |
| exclude_items | No | Up to 20 eBay item numbers (9 to 15 digits) to leave out of the count, summary and list, for example the user's own earlier sale of the same item, which is not independent evidence. Each listed sale's itemId is its eBay item number. |