Introduction

Soldgraph searches marketplace listings by keyword and returns JSON. It covers sold and active listings on eBay, Poshmark and Mercari (US), and active listings on Depop (US).

#Endpoints

GET /v1/ebay/soldeBay sold listingsSearch one page of eBay US sold listings by keyword. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.GET /v1/ebay/listingseBay active listingsSearch one page of eBay US active listings by keyword, in the sort order you pick. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.GET /v1/poshmark/soldPoshmark sold listingsSearch one page of Poshmark US sold listings by keyword. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.GET /v1/poshmark/listingsPoshmark active listingsSearch one page of Poshmark US active listings by keyword, in the sort order you pick. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.GET /v1/mercari/soldMercari sold listingsSearch one page of Mercari US sold listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.GET /v1/mercari/listingsMercari active listingsSearch one page of Mercari US active listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.GET /v1/depop/listingsDepop active listingsSearch one page of Depop US active listings by keyword, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.

Each call returns one page of results from the marketplace, cached for 15 minutes. Prices are the ones the listing shows. They can differ from what the buyer paid.

#Start here

Quickstart · API overview · OpenAPI

#Coming from another source

• findCompletedItems replacement for code that used eBay's retired Finding API.
• Marketplace Insights API alternative if eBay hasn't approved you.
• Terapeak API alternative to get Terapeak-style sold data in code.
• eBay Browse API if you also need sold listings.
• PriceCharting API alternative if you want the listings behind a price.
• Poshmark API and Mercari API if you looked for an official API and found none.
• Depop API if you need to search Depop, not manage a shop.
• Scraping it yourself compared with using the API.

Sample responses in these docs are examples, not live data.