{"uid":"cap_UPcKipcYonJ-HeEBAk-Ew","slug":"ebay-sold-listings-comps-search-ab0fff40","name":"eBay Sold Listings & Comps Search","description":"eBay sold comps — sold & completed listings with realized prices and sold dates for pricing research and resale valuation, filterable by site, category, price band and condition, as clean JSON.","url":"https://ebay.use.x402atlas.com/sold","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"page":{"type":"integer","default":1,"minimum":1,"description":"Result page number; follow next_page from a previous response"},"sort":{"enum":["best_match","ending_soonest","newly_listed","price_shipping_lowest","price_shipping_highest","distance_nearest"],"type":"string","default":"best_match","description":"Sort order"},"query":{"type":"string","maxLength":300,"description":"Free-text query for the item to comp (e.g. \"nintendo switch oled\")"},"domain":{"enum":["ebay.at","ebay.ca","ebay.ch","ebay.co.uk","ebay.com","ebay.com.au","ebay.com.hk","ebay.com.my","ebay.com.sg","ebay.de","ebay.es","ebay.fr","ebay.ie","ebay.it","ebay.nl","ebay.pl"],"type":"string","default":"ebay.com","description":"eBay regional site to search"},"per_page":{"enum":[25,50,100,200],"type":"integer","default":50,"description":"Results per page"},"condition":{"type":"string","description":"Comma-separated condition ids: 1000 New, 1500 Open box, 2000 Certified refurbished, 2500 Seller refurbished, 3000 Used, 10 Not specified"},"max_price":{"type":"number","minimum":0,"description":"Maximum price filter"},"min_price":{"type":"number","minimum":0,"description":"Minimum price filter"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","domain","page","per_page","items"],"properties":{"note":{"type":"string","description":"Present only on a sample response (empty/omitted query): a hint to pass real parameters. The paid request ran; no upstream call was made."},"page":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"bids":{"type":"integer","description":"Auction bid count"},"link":{"type":"string","description":"The listing's eBay page"},"price":{"type":"object","properties":{"raw":{"type":"string"},"extracted":{"type":"number"}},"description":"Listing price; a from/to range flattens to the range string plus the extracted low bound"},"title":{"type":"string"},"rating":{"type":"number"},"seller":{"type":"object","properties":{"username":{"type":"string"},"review_count":{"type":"integer"},"positive_feedback_percent":{"type":"number"}}},"returns":{"type":"string"},"discount":{"type":"string","description":"Discount label, e.g. \"18% off\""},"location":{"type":"string","description":"Where the item ships from"},"shipping":{"type":"object","properties":{"raw":{"type":"string"},"free":{"type":"boolean"},"extracted":{"type":"number"}},"description":"Shipping cost line"},"subtitle":{"type":"string"},"watchers":{"type":"integer"},"condition":{"type":"string"},"sold_date":{"type":"string","description":"Realized sale date — set on /sold results when the upstream marks it"},"sponsored":{"type":"boolean"},"thumbnail":{"type":"string"},"time_left":{"type":"string","description":"Auction time remaining"},"extensions":{"type":"array","items":{"type":"string"},"description":"Listing badges (e.g. \"Free returns\")"},"product_id":{"type":"string","description":"eBay item id — pass to /product for the full listing"},"details_link":{"type":"string","description":"This API's /product URL for the listing"},"quantity_sold":{"type":"integer"},"reviews_count":{"type":"integer"},"original_price":{"type":"object","properties":{"raw":{"type":"string"},"extracted":{"type":"number"}},"description":"Pre-discount price, when the listing is discounted"}}}},"query":{"type":"string","description":"Echoed search query"},"domain":{"type":"string","description":"eBay site actually searched"},"per_page":{"type":"integer"},"next_page":{"type":["integer","null"],"description":"Pass back as page= for the next page; null when this is the last page"},"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}},"description":"Category facets; pass an id back as category_id to narrow the search"},"total_results":{"type":"integer","description":"Total listings matching the query upstream"},"related_searches":{"type":"array","items":{"type":"string"},"description":"Suggested query refinements"}}}}}}},"responseSchema":{"type":"json","example":{"page":1,"items":[{"bids":21,"link":"https://www.ebay.com/itm/157012348890","price":{"raw":"$232.50","extracted":232.5},"title":"Nintendo Switch OLED Model 64GB White Console - Complete in Box","seller":{"username":"gamestop_outlet","review_count":192884,"positive_feedback_percent":98.9},"location":"United States","shipping":{"raw":"Free shipping","free":true},"condition":"Pre-Owned","sold_date":"Jul 21, 2026","sponsored":false,"thumbnail":"https://i.ebayimg.com/images/g/vN8AAOSwq9dnPq0c/s-l500.jpg","product_id":"157012348890","details_link":"https://ebay.use.x402atlas.com/product?product_id=157012348890"},{"link":"https://www.ebay.com/itm/146119207455","price":{"raw":"$268.00","extracted":268},"title":"Nintendo Switch OLED Splatoon 3 Special Edition Console Bundle","seller":{"username":"retro.console.co","review_count":7761,"positive_feedback_percent":99.6},"location":"United States","shipping":{"raw":"+$14.85 shipping","free":false,"extracted":14.85},"condition":"Pre-Owned","sold_date":"Jul 18, 2026","sponsored":false,"thumbnail":"https://i.ebayimg.com/images/g/hR2AAOSwLtJnKd41/s-l500.jpg","product_id":"146119207455","details_link":"https://ebay.use.x402atlas.com/product?product_id=146119207455"}],"query":"nintendo switch oled","domain":"ebay.com","per_page":50,"next_page":2,"categories":[{"id":139971,"name":"Video Game Consoles"},{"id":54968,"name":"Video Game Accessories"}],"total_results":12634,"related_searches":["nintendo switch oled zelda edition","nintendo switch 2","steam deck oled"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2dHcTAOfJv95ELcbFaU6o","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns sold and completed eBay listings with realized prices and sold dates for pricing research and resale valuation, filterable by condition, price band, category, and regional site.","exampleAgentPrompt":"Search eBay sold listings for 'Nintendo Switch OLED' on ebay.com, show me 50 results sorted by best match, condition used (3000), and price between $200 and $350 — I need the realized sale prices and dates to figure out what mine is worth.","exampleUseCases":[{"title":"Resale pricing before listing","prompt":"Pull me the last 50 sold comps on ebay.com for a 'Sony WH-1000XM5 headphones' in used condition — I want to see what they're actually selling for so I can price mine competitively."},{"title":"Collectibles market valuation","prompt":"Search eBay sold listings for 'Pokemon Base Set Booster Box sealed' on ebay.com, give me up to 100 results sorted by newly listed — I need realized prices to figure out what my collection is worth."},{"title":"Cross-regional pricing comparison","prompt":"Find sold comps for 'iPhone 15 Pro 256GB' on ebay.co.uk with a max price of £900 and condition new (1000), 50 results — I want to compare UK realized prices to what I'm seeing in the US market."}],"resultDescription":"A paginated JSON array of sold/completed eBay listings, each containing the item title, realized sale price, currency, sold date, condition, number of bids (if auction), seller username and feedback score, listing URL, item ID, and shipping details. Response includes pagination metadata (page, per_page, total results, next_page cursor) and echoes back the query parameters used.","failureModes":["Empty results array if query yields no sold listings matching filters — adjust query terms or widen price/condition range","Invalid condition ID returns an error or empty set — use documented codes (1000, 1500, 2000, 2500, 3000, 10)","Unsupported domain enum value returns a validation error","min_price greater than max_price may return no results or an error","Truncated or overly broad queries may return irrelevant comps — be specific with model numbers and variants","Rate limiting or upstream eBay unavailability may return 5xx errors"],"whenToPreferThis":"Use this endpoint when you need historical realized sale prices and sold dates from eBay completed listings — ideal for resale valuation, pricing research, collectibles appraisal, or competitive analysis. Prefer this over live-listing search when you want actual transaction prices rather than asking prices. Choose this over general web scraping when you need structured, clean JSON with condition filtering and multi-regional eBay support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:54.126Z","isFirstParty":false}