← Marketplace reference

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.

https://api.compsapi.com

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

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.

FieldMeaning
card.card_numberThe 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.rarityTCGplayer's rarity name (Special Illustration Rare, Mythic).
card.set_codeThe set's short code (MEW, LTR).
raw.release_dateRelease date of the product.
row_typeOnly on summary rows: weekly_summary.
Field in rawMeaning
product_id, product_line, setThe TCGplayer product, its game and its set.
variant, quantity, listing_typeThe printing, the copies in the sale, and the kind of listing.
market_price, lowest_price, active_listingsTCGplayer's market price, the lowest listed price and the number of listings at the time.
transactions, low, high, sku_idWeekly 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" }
]

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