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 APISoldgraph
Sold listingsfindCompletedItems (retired)GET /v1/ebay/sold
Active listingsfindItemsAdvanced (retired)GET /v1/ebay/listings
AutheBay App IDAuthorization: Bearer <key>
ResponseXML or JSON, per-callJSON search job you poll until done
Rows per callOne page40 by default, up to 200 with count
Many keywordsOne call for eachOne batch call for the whole list
Price statsNoneMedian, lowest and highest price on every page
MarketplaceseBay siteseBay (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

  1. Create a free key. Start with 100 free requests, no credit card required.
  2. Send your old keywords value as q. Old item filters map like this: LocatedIn or AvailableTo becomes item_location, ListingType becomes buying_format, sortOrder becomes sort, and categoryId becomes category_id. A minus sign in front of a word in q still leaves it out. See Search inputs for every filter.
  3. Poll poll_url until status is complete. See Search jobs.
  4. Read rows from result.data. Each row has a link back 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=200 for 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-ID to country, like EBAY-GB to uk.

#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