TCGplayer sold data: API reference
TCGplayer is the marketplace for trading card game singles: Magic: The Gathering, Pokemon, One Piece, Yu-Gi-Oh, Lorcana and more. source=tcgplayer returns TCGplayer sales through /v1/sold and /v1/comps, and live TCGplayer listings through /v1/active.
This page is the technical reference. For coverage, examples and pricing see TCGplayer on CompsAPI. Parameters, stats, the AI junk filter and errors shared by every source are in the common reference.
GET /v1/sold?source=tcgplayer&q=charizard+ex+obsidian+flames
GET /v1/comps?source=tcgplayer&q=charizard+ex+obsidian+flames&days=90
GET /v1/sold?source=tcgplayer&q=charizard+ex+199/165&days=900&include=summaries
Coverage
- Individual sales for about the last 120 days, growing. Every sale of a product: price, sale time to the second, condition, printing, language, quantity and shipping. The window grows from there as time passes.
- Weekly summaries back to each product's first week. Most reach back to April 2023, and a few products have weeks from 2022. One row per week per condition and printing, with the week's market price, low, high, quantity and number of transactions. They are opt in: pass
include=summaries. - Every row of
/v1/soldis one real sale.countandstatscount individual sales only. When summary rows exist for your search and were left out,meta.summariessays how many:{"excluded": 35, "include": "summaries"}. - Games. Magic: The Gathering, Pokemon, One Piece, Yu-Gi-Oh, Lorcana and more.
Weekly summaries
include=summaries on /v1/sold adds the weekly rows to items, and the answer carries summaries_included: true. A summary row has row_type: "weekly_summary" at the top level, price is that week's market price, units_sold the copies sold that week, and raw.low, raw.high, raw.transactions and raw.sku_id the detail. stats never counts them. /v1/comps is individual sales only and lists include under ignored_params.
How the keyword resolves
A keyword returns every printing whose name carries all the words: the one ring returns the regular, extended art, borderless and surge foil printings, each with its own raw.product_id. Pokemon and One Piece names include the card number, so there the number works as a keyword and pins one printing (charizard ex 199/165, OP07-073). On Magic and Yu-Gi-Oh the number is not part of the name, so add words from the printing's name instead (extended art, borderless). A printing that was not held yet answers with its newest 25 sales on the first call and its full list shortly after.
What a TCGplayer row carries
Sales with the condition and variant of the copy that sold, where a market price figure gives one number per card. Each row has the common fields plus a card object.
| Field | Meaning |
|---|---|
card.card_number | The number printed on the card, as TCGplayer shows it (199/165, 246, OP07-073). null for sealed products and for the few cards listed without a number. |
card.rarity | TCGplayer's rarity name (Special Illustration Rare, Mythic). |
card.set_code | The set's short code (MEW, LTR). |
raw.release_date | Release date of the product. |
row_type | Only on summary rows: weekly_summary. |
Field in raw | Meaning |
|---|---|
product_id, product_line, set | The TCGplayer product, its game and its set. |
variant, quantity, listing_type | The printing, the copies in the sale, and the kind of listing. |
market_price, lowest_price, active_listings | TCGplayer's market price, the lowest listed price and the number of listings at the time. |
transactions, low, high, sku_id | Weekly summary rows only (include=summaries): the sales the row stands for, their price range and the SKU. |
{
"source": "tcgplayer",
"title": "Charizard ex - 228/197 [SV03: Obsidian Flames] - Charizard ex - 228/197",
"price": 32.87,
"last_sold": "2026-11-17T18:13:03Z",
"condition": "Near Mint",
"format": "FIXED_PRICE",
"shipping_cost": 4.99,
"url": "https://www.tcgplayer.com/product/509989",
"authenticity": {
"basis": "seller_declared",
"verified": false,
"grader": null,
"grade": null,
"cert_number": null
},
"raw": {
"product_id": 509989,
"variant": "Holofoil",
"quantity": 1,
"listing_type": "ListingWithoutPhotos",
"product_line": "Pokemon",
"set": "SV03: Obsidian Flames",
"market_price": 32.66,
"active_listings": 241.0,
"lowest_price": 9.99,
"recent_sales_per_day": 8.33,
"sell_through_days": 28.9
}
}
Condition labels
TCGplayer's own grading of raw singles: Near Mint, Lightly Played, Moderately Played, Heavily Played and Damaged. condition=near mint returns Near Mint sales only, and stats.by_condition gives a median per condition in one call.
Live listings
GET /v1/active?source=tcgplayer&q= returns what is for sale on TCGplayer right now for your search, read at the moment you call. Per-seller listings for the best-matching product: price plus shipping, card condition (Near Mint, Lightly Played and so on), printing, quantity, seller and seller location (city, state, country). raw adds the product id and name, set, TCGplayer market price, the product's total listing count, seller flags, the listing's sku_id, and card_number, rarity and set_code. seller_feedback is filled for large sellers too: TCGplayer shows 50000+, and the row reads 50000.
The answer also carries price_points at the top level: one entry per condition, printing and language that has a price, English first, with sku_id, condition, printing, language, market_price, low_price, high_price, price_count and calculated_at. Each listing repeats the entry for its own condition and printing in raw.price_point.
"price_points": [
{ "sku_id": 7024061, "condition": "Near Mint", "printing": "Foil", "language": "English",
"market_price": 129.2, "low_price": 105.39, "high_price": 164.73, "price_count": 25,
"calculated_at": "2026-11-18T18:14:24.258Z" }
]
- Sort: best_match, newly_listed, price_asc, price_desc.
source=allincludes this marketplace;live_status.tcgplayertells you whether its search answered.total_activecounts the listings this search returned, not every live listing on the site.
A live row from 17 November 2026 (search charizard ex obsidian flames):
{
"item_id": "tcgplayer-896426237",
"title": "Charizard ex - 215/197 [SV03: Obsidian Flames] - Damaged Holofoil",
"url": "https://www.tcgplayer.com/product/509963",
"price": 10.0,
"price_max": null,
"currency": "USD",
"shipping": 1.69,
"shipping_text": null,
"format": "BIN",
"bids": null,
"ends_at": null,
"buy_it_now_available": true,
"best_offer_enabled": false,
"quantity_available": 1,
"condition": "Damaged",
"seller": "example_seller",
"seller_feedback": 36,
"seller_positive_pct": 100.0,
"location": null,
"source": "tcgplayer",
"authenticity": {
"basis": "seller_declared",
"verified": false,
"grader": null,
"grade": null,
"cert_number": null
},
"raw": {
"product_id": 509963,
"product_name": "Charizard ex - 215/197",
"set": "SV03: Obsidian Flames",
"product_line": "Pokemon",
"market_price": 17.91,
"total_listings": 252,
"printing": "Holofoil",
"language": "English",
"listing_type": "standard",
"gold_seller": false,
"verified_seller": false,
"direct_seller": false,
"direct_listing": false,
"listing_id": 896426237
}
}
The shared parameters and fields are under live listings.
Limits
- Individual sales reach back about 120 days. Older periods are in the weekly summaries.
- A printing asked for the first time answers with its newest 25 sales, and its full list on a later call.
- No
signals. TCGplayer sales carry no listing date or seller, so there is no days on market, discount or seller standing. authenticity.basisisseller_declared: these are raw singles graded by the seller.us_saleis an eBay field and isnullhere.