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.
Soldgraph searches eBay US sold listings by keyword and returns one page of results as JSON. 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#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 |
| Marketplaces | eBay sites | eBay, Poshmark, Mercari and Depop (US) |
#Moving your code over
- Create a free key. Free covers 100 requests a month, with no card.
- Send your old
keywordsvalue asq. See Search inputs for condition and price filters. - Poll
poll_urluntilstatusiscomplete. See Search jobs. - Read rows from
result.data. Each row has alinkback to the eBay listing.
#Differences to plan for
- One page per request. A search returns one page of results, not a full sales history. 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.
- US only. Only eBay US is supported today.
#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.