# Soldgraph

> Resale data API for eBay, Poshmark and Mercari sold and active listings; Depop and Whatnot active listings; OfferUp and Facebook Marketplace local listings and listing details; Vinted active listings and listing details (US, UK and Europe); TCGplayer product search and limited recent sales. Results are cached for 15 minutes.

Base URL: https://api.soldgraph.com/v1. Auth: `Authorization: Bearer <key>`. OpenAPI: https://soldgraph.com/openapi.json.

## What sets Soldgraph apart

- **Nine resale marketplaces, one key, one request format:** eBay, Poshmark, Mercari, Depop, Whatnot, OfferUp, Facebook Marketplace, Vinted and TCGplayer. Sold listings on eBay, Poshmark and Mercari; active listings on all eight listing marketplaces; TCGplayer market prices and recent card sales.
- **eBay in 8 countries, each searched on its own site:** US, UK, Canada, Australia, Germany, France, Italy and Spain, in that site's currency.
- **Prices you can use without code:** every page carries a summary with the median, p25, p75, low and high. On eBay sold, every accepted Best Offer row is flagged and `median_excluding_best_offer` is the median of real sale prices.
- **Built for AI agents:** a hosted MCP server at https://api.soldgraph.com/mcp for Claude, Cursor and VS Code, plus llms.txt and an OpenAPI spec.
- **Whole lists at once:** POST /v1/batches prices many searches in one call and returns a CSV.
- **Pay for what you use:** 100 free requests with no credit card, plans from $9, or pay as you go at $10 per 1,000 with no plan. Failed searches are free.
- **Open about uptime:** a public status page with a 90-day history for every marketplace at https://soldgraph.com/status.

## Get started

- [Introduction](https://soldgraph.com/docs/index.md): Soldgraph is a resale data API for listings, with eBay in 8 countries, plus TCGplayer product search and limited recent card sales (US).
- [Quickstart](https://soldgraph.com/docs/quickstart.md): Get a Soldgraph API key, send your first eBay sold listings search, read the median price, and price a whole list in one call.
- [Authentication](https://soldgraph.com/docs/authentication.md): How Soldgraph API keys work: send the key as a bearer token, use one key per project, keep keys on your server, and revoke a leaked key.
- [How prices work](https://soldgraph.com/docs/how-prices-work.md): What displayed prices mean on eBay, Poshmark, Mercari, Depop, Whatnot, OfferUp, Facebook Marketplace, Vinted and TCGplayer, how fresh Soldgraph results are, and what one page of results covers.

## API reference

- [API overview](https://soldgraph.com/docs/api/overview.md): How Soldgraph routes work across resale listings and TCGplayer card products and recent sales, with jobs, caching, retries and pagination.
- [Marketplaces](https://soldgraph.com/docs/marketplaces.md): Sold and active listings for eBay (8 countries), Poshmark (US and Canada) and Mercari (US); active listings for Depop (4 countries), Whatnot (US and Canada), OfferUp, Facebook Marketplace and Vinted (US, UK and 24 European countries); TCGplayer card sales (US).
- [Search inputs](https://soldgraph.com/docs/api/filtering.md): Search and recent-sales parameters by marketplace: keywords, product IDs, page, price range, condition, sort, count and cursor.
- [Batches](https://soldgraph.com/docs/api/batches.md): POST /v1/batches runs many Soldgraph searches in one call. Poll one batch ID for every result, get a price summary per search, or download all rows as CSV.
- [Errors](https://soldgraph.com/docs/api/errors.md): Every Soldgraph API error code, what it means, which ones to retry, and how a failed search job differs from an HTTP error.
- [Rate limits](https://soldgraph.com/docs/api/rate-limits.md): Soldgraph allows 60 API calls per minute per account and caps pending searches by plan. See the 429 codes and a client that backs off.
- [Usage and billing](https://soldgraph.com/docs/api/usage.md): What counts as a Soldgraph API request, what each marketplace costs, the free requests and the monthly allowance on each plan, and how to track your usage.

## eBay

- [eBay sold listings API reference](https://soldgraph.com/docs/api/sold.md): GET /v1/ebay/sold searches eBay sold listings by keyword in the US, UK, Canada, Australia, Germany, France, Italy or Spain, with price and condition filters.
- [eBay active listings](https://soldgraph.com/docs/api/listings.md): GET /v1/ebay/listings searches eBay active listings in the US, UK, Canada, Australia, Germany, France, Italy or Spain, with price, condition and sort filters.

## Poshmark

- [Poshmark sold listings API reference](https://soldgraph.com/docs/api/poshmark-sold.md): GET /v1/poshmark/sold searches one page of Poshmark sold listings by keyword, on Poshmark US or Canada, with condition and price filters, and returns JSON.
- [Poshmark active listings](https://soldgraph.com/docs/api/poshmark-listings.md): GET /v1/poshmark/listings searches one page of Poshmark listings for sale now, on Poshmark US or Canada, by keyword, with condition, price and sort options.

## Mercari

- [Mercari sold listings API reference](https://soldgraph.com/docs/api/mercari-sold.md): GET /v1/mercari/sold searches one page of Mercari US sold listings by keyword, with condition, price, category and brand filters.
- [Mercari active listings](https://soldgraph.com/docs/api/mercari-listings.md): GET /v1/mercari/listings searches one page of Mercari US active listings by keyword, with condition, price, category and brand filters.

## Depop

- [Depop active listings](https://soldgraph.com/docs/api/depop-listings.md): GET /v1/depop/listings searches one page of Depop active listings by keyword, from sellers in the US, UK, Australia or Canada, with condition and price filters and cursor pagination.

## Whatnot

- [Whatnot active listings](https://soldgraph.com/docs/api/whatnot-listings.md): GET /v1/whatnot/listings searches Buy It Now inventory from sellers in the US or Canada, with price, condition, category and grading filters.

## OfferUp

- [OfferUp local listings](https://soldgraph.com/docs/api/offerup-listings.md): GET /v1/offerup/listings searches US OfferUp listings around a ZIP code or exact point, with radius, condition, price, category and vehicle filters.
- [OfferUp listing details](https://soldgraph.com/docs/api/offerup-item.md): GET /v1/offerup/item returns one OfferUp listing with description, posted date, condition, coordinates, shipping, photos, seller and vehicle details.

## Facebook Marketplace

- [Facebook local listings](https://soldgraph.com/docs/api/facebook-listings.md): GET /v1/facebook/listings searches US Facebook Marketplace listings near a ZIP code or exact point, with radius, price, condition, delivery and sort filters.
- [Facebook listing details](https://soldgraph.com/docs/api/facebook-item.md): GET /v1/facebook/item returns one Facebook Marketplace listing with description, condition, posted date, approximate coordinates, delivery and photos.

## Vinted

- [Vinted active listings](https://soldgraph.com/docs/api/vinted-listings.md): GET /v1/vinted/listings searches active Vinted listings on the US, UK or 24 European sites, 96 rows a page, with condition, brand, category, price and sort filters.
- [Vinted listing details](https://soldgraph.com/docs/api/vinted-item.md): GET /v1/vinted/item returns one Vinted listing with description, condition, brand, size, colour, category, photos and the seller's rating.

## TCGplayer

- [TCGplayer product search](https://soldgraph.com/docs/api/tcgplayer-search.md): GET /v1/tcgplayer/search finds products by keyword, including catalog identity, market-price estimate and current asking-price snapshots.
- [TCGplayer recent sales](https://soldgraph.com/docs/api/tcgplayer-sales.md): GET /v1/tcgplayer/sales returns a limited sample of actual recent transactions for one exact product ID.

## Guides

- [Sold listings on every marketplace](https://soldgraph.com/docs/guides/sold-listings-by-marketplace.md): How to see sold listings and sold prices on eBay, Poshmark, Mercari, Depop, Whatnot, Vinted, Facebook Marketplace, OfferUp and TCGplayer, by hand and through one API.
- [Research a list of items](https://soldgraph.com/docs/guides/price-a-list.md): Collect eBay, Poshmark or Mercari sold listings for a whole list of items, without going over the cap on pending searches.
- [Compare active and sold listings](https://soldgraph.com/docs/guides/find-deals.md): Search active and sold listings for the same keywords on eBay, Poshmark or Mercari, then compare the prices in your own code.
- [Build with ChatGPT](https://soldgraph.com/docs/guides/chatgpt.md): Paste one prompt into ChatGPT, Claude or Cursor and get working code that reads eBay sold prices from the Soldgraph API.
- [Resale price data for AI agents](https://soldgraph.com/docs/guides/ai-agents.md): Let an AI agent search resale listings through the Soldgraph HTTP API or the hosted MCP server, using llms.txt or the OpenAPI spec.
- [MCP server](https://soldgraph.com/docs/guides/mcp.md): Connect Claude, Cursor, VS Code or any MCP client to Soldgraph's hosted MCP server and search eBay, Poshmark, Mercari and more with your API key.
- [eBay pricing API for your app](https://soldgraph.com/docs/guides/pricing-feature.md): Suggest a listing price from recent eBay sold listings. Search sold items, take the middle price, and show the comps behind it.
- [eBay sold prices in Google Sheets](https://soldgraph.com/docs/guides/google-sheets.md): Pull eBay sold listings into Google Sheets with a short Apps Script function. Type =SOLDGRAPH_SOLD("item") in any cell.

## Compare

- [eBay findCompletedItems replacement](https://soldgraph.com/docs/compare/ebay-finding-api.md): eBay retired the Finding API and findCompletedItems in February 2025. Soldgraph returns eBay sold listings as JSON with a key you can get today.
- [eBay Marketplace Insights API alternative](https://soldgraph.com/docs/compare/ebay-marketplace-insights-api.md): eBay's Marketplace Insights API has sold data but is closed to new users. Soldgraph gives you eBay sold listings as JSON without partner approval.
- [eBay Browse API vs Soldgraph](https://soldgraph.com/docs/compare/ebay-browse-api.md): The eBay Browse API only returns active listings. Soldgraph returns eBay sold and active listings, plus seven more marketplaces.
- [Terapeak API alternative](https://soldgraph.com/docs/compare/terapeak.md): Terapeak shows eBay sold data inside Seller Hub but has no API. Soldgraph gives you eBay sold listings as JSON for your app, sheet or agent.
- [PriceCharting API alternative: real sold listings](https://soldgraph.com/docs/compare/pricecharting-api.md): PriceCharting's API needs a paid plan and returns its own price guides. Soldgraph returns the raw eBay, Poshmark, Mercari and Depop listings behind a price.
- [Scraping eBay sold listings yourself](https://soldgraph.com/docs/compare/scraping-ebay.md): What it takes to scrape eBay, Poshmark and Mercari sold listings yourself, and when an API is cheaper.
- [Poshmark API](https://soldgraph.com/docs/compare/poshmark-api.md): Poshmark has no public API. Soldgraph returns Poshmark sold and active listings, US and Canada, as JSON with a free key.
- [Mercari API](https://soldgraph.com/docs/compare/mercari-api.md): Mercari US has no public developer API. Soldgraph returns Mercari US sold and active listings as JSON with a free key.
- [Depop API](https://soldgraph.com/docs/compare/depop-api.md): Depop's Selling API is for approved sellers managing their own shops. Soldgraph returns Depop active listings by keyword as JSON, from sellers in the US, UK, Australia or Canada.

## Tools

- [OpenAPI spec](https://soldgraph.com/docs/openapi.md): The Soldgraph OpenAPI 3.1 spec, for generating typed clients in any language and importing the API into Postman, Insomnia or Bruno.
- [Docs for agents](https://soldgraph.com/docs/agents.md): Every Soldgraph docs page as plain Markdown, plus llms.txt, so AI tools can read the docs directly.

## Use cases

- [eBay sold listings API](https://soldgraph.com/ebay-sold-listings-api)
- [findCompletedItems alternative](https://soldgraph.com/findcompleteditems-alternative)
- [Poshmark sold listings API](https://soldgraph.com/poshmark-sold-listings-api)
- [Mercari sold listings API](https://soldgraph.com/mercari-sold-listings-api)
- [Pokémon card price API](https://soldgraph.com/pokemon-card-price-api)
- [Sold comps API for reseller apps](https://soldgraph.com/sold-comps-api)
- [Sold listings on every marketplace](https://soldgraph.com/docs/guides/sold-listings-by-marketplace.md): what each marketplace shows for past sales and what Soldgraph returns from it.

## Free tools

- [eBay sold listings search](https://soldgraph.com/tools/ebay-sold-listings): free search of eBay, Mercari and Poshmark sold listings with the median price, range and recent sales; no sign-in, five searches a day.
- [Card price checker](https://soldgraph.com/tools/card-price-checker): free search of recent eBay and Mercari sales for Pokémon and sports cards, graded or raw, with the median price and Best Offer sales flagged; no sign-in.
- [Reseller spreadsheet](https://soldgraph.com/tools/reseller-spreadsheet): free Google Sheets inventory sheet that fills in the median sold price from eBay, Mercari or Poshmark for each item, plus estimated fees and profit.
- [Marketplace fee calculator](https://soldgraph.com/tools/marketplace-fee-calculator): seller fees, payout and profit for one sale on eBay, Whatnot, Depop, Mercari, Poshmark, Facebook Marketplace and Vinted, side by side.
- [eBay fee calculator](https://soldgraph.com/tools/ebay-fee-calculator): eBay seller fees, payout and profit for a US sale.
- [Whatnot fee calculator](https://soldgraph.com/tools/whatnot-fee-calculator): Whatnot seller fees, payout and profit for a US sale.
- [Depop fee calculator](https://soldgraph.com/tools/depop-fee-calculator): Depop seller fees, payout and profit for a US sale.
- [Mercari fee calculator](https://soldgraph.com/tools/mercari-fee-calculator): Mercari seller fees, payout and profit for a US sale.
- [Poshmark fee calculator](https://soldgraph.com/tools/poshmark-fee-calculator): Poshmark seller fees, payout and profit for a US sale.
- [Facebook Marketplace fee calculator](https://soldgraph.com/tools/facebook-marketplace-fee-calculator): Facebook Marketplace seller fees, payout and profit for a US sale.
- [Vinted fee calculator](https://soldgraph.com/tools/vinted-fee-calculator): Vinted seller fees, payout and profit for a US sale.

## Comparisons

- [Best eBay sold listings APIs, compared](https://soldgraph.com/compare): every option below in one table, with coverage, price and a verdict.
- [Soldgraph vs SoldComps](https://soldgraph.com/compare/soldcomps): Soldgraph is the stronger choice for eBay sold comps. It covers the same 8 eBay countries, sold and active, up to 200 rows per search and 100 pages deep, matches SoldComps' $9 for 2,000, and from Starter up costs less per search: $3.80 per 1,000 against SoldComps' $4.50, $2.45 against $2.90, and $1.49 against $1.58. You can buy searches once with no subscription, every page comes with its median, low and high price, and whole lists price in one batch with a CSV. The same key also covers Poshmark, Mercari, Depop, Whatnot, OfferUp, Facebook Marketplace, Vinted and TCGplayer.
- [Soldgraph vs CompSniper](https://soldgraph.com/compare/compsniper): Soldgraph is the stronger choice for eBay sold comps from small to mid volume, and for anyone who sells beyond eBay. It matches CompSniper's $9 for 2,000, and from Starter up costs less per search than CompSniper's $9, $29 and $79 plans ($3.80, $2.45 and $1.49 per 1,000 against $4.50, $2.90 and $1.58), extra searches on a plan are $3 per 1,000 against $5, and you can buy searches with no subscription. Every response carries its price summary, results go up to 200 rows per search and 100 pages deep, and the same key covers Depop, Whatnot, OfferUp, Facebook Marketplace, Vinted and TCGplayer.
- [Soldgraph vs eBay Sold Listings API](https://soldgraph.com/compare/ebaysoldlistingsapi): Soldgraph is the stronger choice for most sellers and developers. On eBay it covers the same 8 countries, sold and active, up to 200 rows per search and 100 pages deep, with the median, low and high price on every page. It starts you with 100 free searches, and sells searches with no subscription. And when you need Poshmark, Mercari, Depop, Whatnot, OfferUp, Facebook Marketplace, Vinted or TCGplayer, it's the same key and the same request.
- [Soldgraph vs Trawl](https://soldgraph.com/compare/trawl): Soldgraph is the stronger choice when you want what eBay shows now. It searches live in 8 eBay countries against Trawl's 2, returns active listings as well as sold ones, gives up to 200 rows per search against 100 per Trawl credit, and adds the median, low and high price to every page. Pay as you go with no plan, and eight more marketplaces on the same key.
- [Soldgraph vs Apify eBay scrapers](https://soldgraph.com/compare/apify): Soldgraph is the stronger choice for eBay sold comps at any real volume. It charges per search, not per row, so a 200-row page costs under a cent on any paid plan, against $0.50 to $0.80 on a $2.50 to $4.00 per 1,000 actor. It also adds a price summary to every page, keeps working after eBay's July 2026 sign-in change, and covers eight more marketplaces with one API.
- [Soldgraph vs SerpApi](https://soldgraph.com/compare/serpapi): Soldgraph is the right choice for eBay sold prices: SerpApi's docs say its eBay Sold and Complete options are deprecated and no longer supported. Soldgraph returns eBay sold and active listings in 8 countries with a price summary on every page, up to 200 rows per search, and $19 buys 5,000 searches against SerpApi's $25 for 1,000.
- [Soldgraph vs ScraperAPI, Bright Data and Oxylabs](https://soldgraph.com/compare/ebay-scraper-apis): Soldgraph is the stronger choice when what you need is resale price data. You send a keyword and get clean eBay sold and active rows in 8 countries, up to 200 per search, with the median, low and high price, for one request per search, and failed searches cost nothing. There are no URLs, filters or parsers to maintain, and the same API covers eight more marketplaces.
- [Soldgraph vs eBay's sold listings search](https://soldgraph.com/compare/ebay-sold-listings): Soldgraph is the better way to check eBay sold prices once you price more than a few items, or want the numbers in a sheet, app or AI assistant. It returns the sales as data with the median, low and high price, up to 200 rows per search in 8 eBay countries, and prices whole lists in one batch. eBay's own Sold items filter is fine for an occasional check by hand.
- [Soldgraph vs Terapeak](https://soldgraph.com/compare/terapeak): Soldgraph is the choice when you need eBay sold prices outside Seller Hub: in your own tool, a spreadsheet or an AI assistant. It returns sold and active listings with the median price, in 8 eBay countries, and covers eight more marketplaces. Terapeak is a by-hand research screen with no API.
- [Soldgraph vs 130point](https://soldgraph.com/compare/130point): Soldgraph is the choice for pricing cards and collectibles in a spreadsheet, bot or app: it returns eBay sold listings in 8 countries with the median price, plus TCGplayer market prices and recent sales, by API. 130point is a by-hand lookup site with no public API, though it does show accepted Best Offer prices.
- [Soldgraph vs WorthPoint](https://soldgraph.com/compare/worthpoint): Soldgraph is the choice for current comps: sold and active listings from nine marketplaces as data, with the median price, starting free and with no subscription needed. WorthPoint is a paid archive of past sales for researching antiques by hand, with no public API.
- [Soldgraph vs PriceCharting](https://soldgraph.com/compare/pricecharting): Soldgraph is the choice when you want the sales behind a price: real eBay sold and active listings in 8 countries, each with a link, plus eight more marketplaces, for any item, from a free API tier. PriceCharting gives one guide price per game, card or comic, and its API needs a paid subscription.