Quickstart
Get a Soldgraph API key, send your first eBay sold listings search, and poll the job until the JSON result is ready.
#Get a key
Create an account and create a key in API keys. Save it as SOLDGRAPH_KEY in your environment. The key is shown once.
#Search eBay sold listings
curl -G https://api.soldgraph.com/v1/ebay/sold \ -H "Authorization: Bearer $SOLDGRAPH_KEY" \ --data-urlencode "q=sony wh-1000xm5" \ -d page=1#Get the result
The first call for a search usually returns 202 with status=pending and a poll_url. Poll it with the same key and ?wait=20 until status is complete or failed:
Poll the job
curl "https://api.soldgraph.com/v1/jobs/REQUEST_ID?wait=20" \ -H "Authorization: Bearer $SOLDGRAPH_KEY"poll_url is a path, so join it to https://api.soldgraph.com. If someone ran the same search in the last 15 minutes, you get 200 and the result right away.
Search jobs explains the full flow, retries and pagination.
#Example response
A complete response looks like this. The data is an example.
Response
{ "request_id": "00000000-0000-4000-8000-000000000001", "status": "complete", "credits": 1, "cached": false, "result": { "provider": "ebay", "country": "us", "query": "sony wh-1000xm5", "page": 1, "page_size": 40, "count": 1, "reported_total": 1, "next_page": null, "next_cursor": null, "collected_at": "2026-09-23T14:02:11Z", "schema_version": 1, "completeness": "provider_page_only", "data": [ { "id": "123456789012", "title": "Example eBay listing", "link": "https://www.ebay.com/itm/123456789012", "displayed_price": { "amount": 189, "currency": "USD" }, "displayed_price_text": "$189.00", "displayed_shipping": { "amount": 9.99, "currency": "USD" }, "shipping_text": "+$9.99 delivery", "sold_date": "2026-09-21", "sold_date_text": "Sep-21 14:35", "condition": "Pre-Owned", "seller_text": "sonyfan_outlet (2,418) 99.6%", "brand": null, "size": null, "image": "https://i.ebayimg.com/images/g/example/s-l500.jpg", "price": null, "shipping": null, "sold_at": null, "took_offer": null } ], "field_notes": "Unverified fields are null. Displayed prices are not verified accepted-offer prices." }}Try it