eBay findCompletedItems replacement
eBay retired the Finding API and findCompletedItems in February 2025. Soldgraph returns eBay sold listings as JSON with a key you can get today.
Last updated
Use eBay sold listings as the replacement for findCompletedItems. eBay decommissioned the Finding API, including findCompletedItems, in February 2025. Its public Browse API only returns active listings. Its sold-data API, Marketplace Insights, isn't open to new users. The findCompletedItems alternative page has the short version.
Soldgraph searches eBay sold listings by keyword and returns one page of results as JSON, with the median, lowest and highest price worked out. It covers eBay US, UK, Canada, Australia, Germany, France, Italy and Spain. You don't need an eBay developer account or partner approval.
curl -G https://api.soldgraph.com/v1/ebay/sold \ -H "Authorization: Bearer $SOLDGRAPH_KEY" \ --data-urlencode "q=sony wh-1000xm5" \ -d page=1 \ -d count=200#What changed
| Finding API | Soldgraph | |
|---|---|---|
| Sold listings | findCompletedItems (retired) | GET /v1/ebay/sold |
| Active listings | findItemsAdvanced (retired) | GET /v1/ebay/listings |
| Auth | eBay App ID | Authorization: Bearer <key> |
| Response | XML or JSON, per-call | JSON search job you poll until done |
| Rows per call | One page | 40 by default, up to 200 with count |
| Many keywords | One call for each | One batch call for the whole list |
| Price stats | None | Median, lowest and highest price on every page |
| Marketplaces | eBay sites | eBay (8 sites), plus Poshmark (US and Canada), Depop (US, UK, Australia and Canada), Whatnot (US and Canada), Vinted (US, UK and Europe), and Mercari, OfferUp, Facebook Marketplace and TCGplayer (US) |
#Moving your code over
- Create a free key. Start with 100 free requests, no credit card required.
- Send your old
keywordsvalue asq. Old item filters map like this:LocatedInorAvailableTobecomesitem_location,ListingTypebecomesbuying_format,sortOrderbecomessort, andcategoryIdbecomescategory_id. A minus sign in front of a word inqstill leaves it out. See Search inputs for every filter. - Poll
poll_urluntilstatusiscomplete. See Search jobs. - Read rows from
result.data. Each row has alinkback to the eBay listing.
For before-and-after code in Python and Node, plus a field-by-field mapping, see the findCompletedItems migration example on GitHub.
#Differences to plan for
- One page per request. A search returns one page of results, not a full sales history. Send
count=200for a bigger page, or page through results if you need more rows. - Displayed prices. Sold prices are what the listing showed. Best offers and bundles can change what the buyer paid. See How prices work.
- 8 eBay sites. We cover the US, UK, Canada, Australia, Germany, France, Italy and Spain. Map your old
GLOBAL-IDtocountry, likeEBAY-GBtouk.
#Common questions
Does eBay still have a sold items API? Only Marketplace Insights, which eBay says is restricted and not open to new users. See Marketplace Insights API alternative.
Can I get findCompletedItems data from the Browse API? No. The Browse API returns active listings only. See eBay Browse API vs Soldgraph.
Overviews: eBay sold listings API · findCompletedItems alternative · Poshmark sold listings API · Mercari sold listings API · Pokémon card price API · Sold comps API for reseller apps