How prices work
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.
#Displayed prices
result.data[].displayed_price is the amount and currency the listing shows.
- eBay sold listings: the price eBay shows for the sale. When
best_offer_acceptedis true, the sale closed on an accepted Best Offer; eBay does not publish that amount, so the price is the seller's ask. These rows are flagged and left out ofsummary.median_excluding_best_offer. - eBay active listings: the asking price or current bid.
- Poshmark sold listings: the listing's asking price, in US dollars or Canadian dollars on Poshmark Canada. Offers and bundles can change what the buyer paid.
- Poshmark active listings: the seller's current asking price.
- Mercari sold and active listings: the listing amount Mercari shows, not a verified final payment. Sold timestamps come from Mercari and can be missing.
- Whatnot active listings: seller asks for Buy It Now inventory from US or Canadian sellers, in that country's currency, excluding shipping and checkout charges. Unequal variant ranges have a null
displayed_price. No sold search or final sale prices. - OfferUp local listings and details: the seller's current ask, often negotiable in person. Dealer vehicles can be "call for price", with a null
displayed_price. A listing'ssoldstatus is set by the seller and carries no sale price. - Facebook Marketplace listings and details: the seller's current ask in USD, often negotiable. A listing's
soldstatus is set by the seller and carries no sale price. - Vinted listings: the seller's ask for the item, in the site's currency.
total_priceadds Vinted's buyer protection fee. Shipping is extra. Listing details show the ask in the currency the seller listed in. No sold search or sale prices. - Depop active listings: Depop's headline price, in the currency of the country you searched. It can include buyer fees, shipping or tax.
price_includeslists which ones. - TCGplayer:
market_priceis TCGplayer's own estimate.lowest_askandlisted_medianare seller asks. Recent sales carrypurchase_price, the item price without shipping.
We can't verify the final sale price, so sold listing rows have only the displayed price, never a "paid" price. Each row has only the fields its marketplace can fill. The text the marketplace shows stays in fields like displayed_price_text and sold_date_text. Parsed amounts are always { amount, currency }, next to the original text.
#Coverage and freshness
Each response covers one page from the marketplace, marked completeness: "provider_page_only". result.count is the number of rows on that page. reported_total is the total the marketplace reports for the search, not a count of verified sales. There's no fixed history window, like 90 days.
Matching searches share a 15-minute cache. Check cached and result.collected_at to see how fresh a result is. A cache miss starts a search job.
#Your own analysis
Every listing search returns a summary with the median, lowest and highest displayed price on the page. It is plain maths over the rows you got, with nothing removed. Anything further, like trends or dropping outliers, is your own calculation.
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