Introduction

Soldgraph is a resale data API for listings, with eBay in 8 countries, plus TCGplayer product search and limited recent card sales (US).

Soldgraph searches marketplace listings by keyword and returns JSON. It covers sold and active listings on eBay (US, UK, Canada, Australia, Germany, France, Italy and Spain), sold and active listings on Poshmark (US and Canada) and Mercari (US), active listings on Depop (US, UK, Australia and Canada), Whatnot (US and Canada), OfferUp and Facebook Marketplace (US), active listings on Vinted (US, UK and 24 European countries), and TCGplayer products with limited recent card sales by product ID.

#Endpoints

GET /v1/ebay/soldeBay sold listingsSearch one page of eBay sold listings by keyword, on eBay US or seven other countries. A page holds up to 200 rows with count=200, or 40 without it. 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 active listings by keyword, on eBay US or seven other countries, in the sort order you pick. A page holds up to 200 rows with count=200, or 40 without it. 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 sold listings by keyword, on Poshmark US or Canada. 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 active listings by keyword, on Poshmark US or Canada, 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 active listings by keyword, from sellers in the US, UK, Australia or Canada, 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/whatnot/listingsWhatnot active listingsSearch one page of Whatnot Buy It Now active listings from sellers in the US or Canada, up to 24 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.GET /v1/tcgplayer/searchTCGplayer product searchSearch TCGplayer products by keyword; returns catalog identity, source market-price estimate and a few active seller asks. Cached 15 minutes; a cache miss returns 202 to poll.GET /v1/tcgplayer/salesTCGplayer recent salesFetch an exact product’s recent individual sales. Anonymous source access has shown at most five rows; this is not a complete sales history. Cached 15 minutes; a cache miss returns 202 to poll.GET /v1/offerup/listingsOfferUp local listingsSearch one page of OfferUp US active listings near a ZIP code or point, about 50 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.GET /v1/offerup/itemOfferUp listing detailsFetch one OfferUp listing by ID or URL: description, posted date, condition, coordinates, shipping, photos, seller and vehicle details. Status is the seller-set state, not a verified sale. Cached 15 minutes; a cache miss returns 202 to poll.GET /v1/facebook/listingsFacebook local listingsSearch Facebook Marketplace US active listings near a ZIP code or point, up to about 24 rows. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.GET /v1/facebook/itemFacebook listing detailsFetch one Facebook Marketplace listing by ID or URL: description, condition, posted date, approximate coordinates, delivery and photos. Status is the seller-set state, not a verified sale. Cached 15 minutes; a cache miss returns 202 to poll.GET /v1/vinted/listingsVinted active listingsSearch one page of Vinted active listings by keyword, on Vinted US, UK or 24 European sites, 96 rows a page. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.GET /v1/vinted/itemVinted listing detailsFetch one Vinted listing by ID or URL: description, condition, brand, size, colour, category, photos and the seller's rating. Status is not a verified sale. Cached 15 minutes; a cache miss returns 202 to poll.

Each call returns one marketplace page or recent-sales sample, cached for 15 minutes. Listing asks, source-calculated market prices and actual TCGplayer sale prices are separate fields.

#Start here

Quickstart · API overview · OpenAPI

#Coming from another source

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

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