Research a list of items

Collect eBay, Poshmark or Mercari sold listings for a whole list of items, without going over the cap on pending searches.

The quickest way is a batch: send the whole list in one call, poll one ID, and read a price summary per item or download every row as CSV.

Price three items in one call
curl -X POST "https://api.soldgraph.com/v1/batches" \  -H "Authorization: Bearer $SOLDGRAPH_KEY" \  -H "Content-Type: application/json" \  -d '{    "defaults": { "endpoint": "ebay/sold", "sort": "recently_sold", "count": 120 },    "searches": [ { "q": "RX 580 4GB" }, { "q": "GTX 1660 Ti" }, { "q": "Ryzen 7 5800X" } ]  }'

A batch holds as many searches as your plan allows pending at once. For a longer list, send one batch, wait for it to finish, then send the next.

To send searches one at a time instead, use the steps below.

For each item, send an eBay sold listings, Poshmark sold listings or Mercari sold listings search with specific keywords. Give each search its own Idempotency-Key, and reuse that key only when you retry the same search.

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

Keep only a few searches pending at a time. Each account has a cap on pending searches, and going over it returns 429 too_many_pending. Long-poll each job with ?wait=20 and send the next search when one finishes. The client in Rate limits does this for one search.

Store result.data with collected_at and each row's link. Every listing search carries a summary with the median, lowest and highest displayed price on the page. It is plain maths over the rows you got, not a valuation. One page isn't a full history, and displayed prices can differ from what the buyer paid.

To turn the rows into a suggested price in your app, see eBay pricing API for your app. To work in a spreadsheet instead, see Google Sheets.

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