TCGplayer Trading Card API

レスポンスに関する注記

- `variants` are the line's printings in TCGplayer's display order. Printings belong to one product line and their ids are not shared: Pokemon `Normal` is `10` and Magic `Normal` is `1`. The labels seen across all 71 lines on 2026-10-26 are `1st Edition`, `1st Edition - Ultimate`, `1st Edition Cold Foil`, `1st Edition Foil`, `1st Edition Holofoil`, `1st Edition Normal`, `1st Edition Rainbow Foil`, `1st Wave Foil`, `Card Only`, `Card and Die`, `Cold Foil`, `Die Only`, `Foil`, `Holo`, `Holofoil`, `Holohex`, `Limited`, `Metal`, `Normal`, `Parallel Foil`, `Plastic`, `Promo`, `Rainbow Foil`, `Reverse Holo`, `Reverse Holofoil`, `Unlimited`, `Unlimited - Ultimate`, `Unlimited Edition Foil`, `Unlimited Edition Normal`, `Unlimited Edition Rainbow Foil`, `Unlimited Holofoil` and `Unopened`; each line offers only some of them. - `conditions` are `Near Mint`, `Lightly Played`, `Moderately Played`, `Heavily Played`, `Damaged` and `Unopened` (sealed product). Some lines offer only some of them (14 lines offer only `Unopened`). - `languages` are `English`, `Chinese (S)`, `Chinese (T)`, `French`, `German`, `Italian`, `Japanese`, `Korean`, `Portuguese`, `Russian` and `Spanish`. Their ids (1 to 11) are the same on every line. Most lines carry English only; Magic carries all eleven, Flesh and Blood English, Japanese and Korean, Lorcana English, Chinese (S) and Japanese, Grand Archive English and Chinese (T), and Pokemon Japan Japanese only. - `listing_types` are `all`, `with-photos` and `without-photos`. - An unknown `product_line` returns `400`; an unknown product `id` returns `404`. The catalog is cached for 15 minutes. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "product_line": "pokemon", "product_line_id": 3, "variants": [ { "id": 10, "name": "Normal" }, { "id": 11, "name": "Holofoil" }, { "id": 77, "name": "Reverse Holofoil" } ], "conditions": [ { "id": 1, "name": "Near Mint", "abbreviation": "NM" }, { "id": 2, "name": "Lightly Played", "abbreviation": "LP" }, { "id": 3, "name": "Moderately Played", "abbreviation": "MP" } ], "languages": [ { "id": 1, "name": "English", "abbreviation": "EN" } ], "listing_types": [ "all", "with-photos", "without-photos" ] } } ```

レスポンスに関する注記

- `next_offset` is the offset of the next page and is omitted on the last page or when the next same-size page would pass the 9999 window. - Prices are US dollars. `market_price`, `lowest_price`, `lowest_price_with_shipping` and `median_price` are omitted for products with no recent sales or listings. - `facets` lists the product lines, sets, rarities, card types, energy types and product types present in the results, with counts. `sets[].url_value` is the value to pass as `set`. - Result order can shift slightly between calls because TCGplayer ranks by live sales, so page through with a single sort rather than relying on a stable relevance order. - `url` and `image_url` are tcgplayer.com links; images are not downloaded. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "query": "charizard", "total": 2, "limit": 3, "offset": 0, "products": [ { "product_id": 42382, "name": "Charizard", "url": "https://www.tcgplayer.com/product/42382", "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/42382.jpg", "product_line": "Pokemon", "set_name": "Base Set", "set_code": "BS", "rarity": "Holo Rare", "number": "004/102", "card_types": [ "Pokemon" ], "sealed": false, "foil_only": true, "market_price": 954.65, "lowest_price": 207.29, "lowest_price_with_shipping": 207.3, "total_listings": 138 }, { "product_id": 657516, "name": "Charizard (Black Dot Error)", "url": "https://www.tcgplayer.com/product/657516", "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/657516.jpg", "product_line": "Pokemon", "set_name": "Base Set", "set_code": "BS", "rarity": "Holo Rare", "number": "004/102", "card_types": [ "Pokemon" ], "sealed": false, "foil_only": true, "lowest_price": 549.99, "lowest_price_with_shipping": 549.99, "total_listings": 6 } ], "facets": { "product_lines": [ { "value": "Pokemon", "url_value": "pokemon", "count": 2 } ], "sets": [ { "value": "SWSH: Crown Zenith", "url_value": "swsh-crown-zenith", "count": 7 }, { "value": "Base Set", "url_value": "base-set", "count": 2 } ], "rarities": [ { "value": "Holo Rare", "count": 2 } ], "card_types": [ { "value": "Pokemon", "count": 2 } ], "energy_types": [ { "value": "Fire", "count": 2 } ], "product_types": [ { "value": "Cards", "count": 2 } ] } } } ```

レスポンスに関する注記

- `description` is the card text as plain text (TCGplayer sends HTML); `number` is the collector number. - `attributes` holds the other labeled facts TCGplayer shows (artist, card type, ...), which differ by product line. - `skus` lists every purchasable condition, variant (printing) and language combination with its TCGplayer SKU id. - `price_points` has one entry per printing with `market_price`, `listed_median_price` and `buylist_market_price`. A figure is omitted when TCGplayer has none. - Prices are US dollars. `total_listings` and `total_sellers` count current offers. - An unknown product id returns `404`. This call makes two upstream requests and is billed as two. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "product": { "product_id": 42382, "name": "Charizard", "url": "https://www.tcgplayer.com/product/42382", "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/42382.jpg", "product_line": "Pokemon", "product_line_url_name": "pokemon", "product_type": "Cards", "set_name": "Base Set", "set_code": "BS", "rarity": "Holo Rare", "number": "004/102", "description": "Pokémon Power: Energy Burn As often as you like during your turn (before your attack), you may turn all Energy…", "sealed": false, "foil_only": true, "normal_only": false, "market_price": 954.65, "lowest_price": 207.29, "lowest_price_with_shipping": 207.3, "total_listings": 139, "total_sellers": 75, "attributes": { "Artist": "Mitsuhiro Arita", "Attack 1": "[RRRR] Fire Spin (100)\nDiscard 2 Energy cards attached to Charizard in order to use this attack.", "Card Number / Rarity": "004/102 / Holo Rare", "Card Text": "Pokémon Power: Energy Burn As often as you like during your turn (before your attack), you may turn all Energy…", "Card Type / HP / Stage": "Fire / 120 / Stage 2", "TCGplayer Tip": "The Holo Rare Charizard card from Base Set has been the holy grail of Pokémon collectibles since 1999, and man…", "Weakness / Resistance / Retreat Cost": "W / F-30 / 3" }, "skus": [ { "sku": 2999652, "condition": "Near Mint", "variant": "Holofoil", "language": "English" }, { "sku": 2999653, "condition": "Lightly Played", "variant": "Holofoil", "language": "English" }, { "sku": 2999654, "condition": "Moderately Played", "variant": "Holofoil", "language": "English" } ], "price_points": [ { "printing": "Normal" }, { "printing": "Foil", "market_price": 954.65, "listed_median_price": 587.98 } ] } } } ```

レスポンスに関する注記

- `seller_name` is the seller's public TCGplayer storefront name. `seller_sales` is a count as text, and `10000+` for the largest sellers. - Prices are US dollars; `price` is per item and `shipping_price` is that listing's shipping. - `next_offset` is omitted on the last page. - An unknown product id returns `404`. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "product_id": 42382, "total": 18, "limit": 3, "offset": 0, "next_offset": 3, "listings": [ { "listing_id": 4749605, "seller_name": "jlittleton", "seller_rating": 100, "seller_sales": "15", "gold_seller": false, "verified_seller": false, "direct_seller": false, "condition": "Near Mint", "printing": "Holofoil", "language": "English", "quantity": 1, "price": 1098, "shipping_price": 4.99, "listing_type": "custom" }, { "listing_id": 4743494, "seller_name": "Comic Buying Center", "seller_rating": 100, "seller_sales": "3543", "gold_seller": true, "verified_seller": true, "direct_seller": false, "condition": "Near Mint", "printing": "Holofoil", "language": "English", "quantity": 1, "price": 1100, "shipping_price": 3, "listing_type": "custom", "seller_city": "LIBERTYVILLE", "seller_state": "IL", "seller_country": "US" }, { "listing_id": 4740111, "seller_name": "PokeGirlCC", "seller_rating": 100, "seller_sales": "1085", "gold_seller": true, "verified_seller": false, "direct_seller": false, "condition": "Near Mint", "printing": "Holofoil", "language": "English", "quantity": 1, "price": 1199.99, "shipping_price": 2.49, "listing_type": "custom", "seller_city": "Riverview", "seller_state": "FL", "seller_country": "US" } ], "facets": { "conditions": [ { "value": "Near Mint", "count": 18 } ], "printings": [ { "value": "Holofoil", "count": 18 } ], "languages": [ { "value": "English", "count": 18 } ] } } } ```

レスポンスに関する注記

- Rows come back in a fixed order, so paging with `next_offset` walks the whole set without repeats. `total` is the number of rows in the set, not the number of cards: a card appears once per condition and printing (a card with one printing has five rows, one per condition). - `condition` is one of `Near Mint`, `Lightly Played`, `Moderately Played`, `Heavily Played` or `Damaged`. TCGplayer folds the printing and sometimes a language into that text (for example `Near Mint Holofoil` or `Near Mint Foil - Japanese`); the response splits them into `condition`, `printing` and `language`. `language` is omitted when TCGplayer does not mark one. - `low_price` and `market_price` are US dollars; `sales` is the units sold TCGplayer counts for that row. - Only cards are listed; sealed products are not part of this price guide. Use `product_id` with `tcgplayer-product` for a card's detail. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "set_id": 604, "set_name": "Base Set", "set_abbreviation": "BS", "game": "Pokemon", "total": 505, "limit": 4, "offset": 0, "next_offset": 4, "rows": [ { "product_id": 42386, "name": "Abra", "number": "043/102", "rarity": "Common", "condition": "Damaged", "printing": "Normal", "low_price": 0.09, "market_price": 0.25, "sales": 0 }, { "product_id": 42386, "name": "Abra", "number": "043/102", "rarity": "Common", "condition": "Heavily Played", "printing": "Normal", "low_price": 0.09, "market_price": 0.31, "sales": 0 }, { "product_id": 42386, "name": "Abra", "number": "043/102", "rarity": "Common", "condition": "Lightly Played", "printing": "Normal", "low_price": 0.09, "market_price": 0.59, "sales": 0 }, { "product_id": 42386, "name": "Abra", "number": "043/102", "rarity": "Common", "condition": "Moderately Played", "printing": "Normal", "low_price": 0.09, "market_price": 0.41, "sales": 0 } ] } } ```

レスポンスに関する注記

- `skus` has one entry per condition, printing (`variant`) and `language`, each with its `buckets`. Buckets run newest first: daily for `month` (30), every 3 days for `quarter` (30) and weekly for `semi-annual` (26) and `annual` (52). `start_date` is the first day of the bucket. - Prices are US dollars. `market_price` is TCGplayer's market price for that period; `quantity_sold` and `transaction_count` count completed sales. - A product with no sales history, or an id that does not exist, returns an empty `skus` list. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "product_id": 42382, "range": "month", "skus": [ { "sku": 2999655, "variant": "Holofoil", "language": "English", "condition": "Heavily Played", "average_daily_quantity_sold": 0, "average_daily_transaction_count": 0, "total_quantity_sold": 29, "total_transaction_count": 29, "buckets": [ { "start_date": "2026-10-25", "market_price": 247.58, "quantity_sold": 0, "transaction_count": 0, "low_sale_price": 0, "high_sale_price": 0, "low_sale_price_with_shipping": 0, "high_sale_price_with_shipping": 0 } ] } ] } } ```

レスポンスに関する注記

- TCGplayer returns the five most recent sales and offers no paging, so there are at most five rows. Use `tcgplayer-price-history` for a longer trend. - Filters apply to the five most recent sales that match them, not to the five most recent sales overall, so a filtered call can return sales older than an unfiltered one. A filter nobody has sold under returns an empty `sales` list. - A `variant` or `language` filter makes one extra call to read the product line's filter values (cached for 15 minutes); the other filters do not. Printing ids belong to one product line, which is why the labels are resolved per product. - Prices are US dollars. `order_date` is an RFC 3339 timestamp. - Buyer and seller identities are not part of the response. - A product with no recent sales returns an empty `sales` list. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "product_id": 42382, "sales": [ { "condition": "Damaged", "variant": "Holofoil", "language": "English", "quantity": 1, "purchase_price": 220, "shipping_price": 0, "listing_type": "ListingWithoutPhotos", "order_date": "2026-10-24T17:53:24.483+00:00" }, { "condition": "Heavily Played", "variant": "Holofoil", "language": "English", "quantity": 1, "purchase_price": 246.49, "shipping_price": 0.99, "listing_type": "ListingWithoutPhotos", "order_date": "2026-10-24T13:37:33.393+00:00" }, { "condition": "Heavily Played", "variant": "Holofoil", "language": "English", "quantity": 1, "purchase_price": 240, "shipping_price": 0, "listing_type": "ListingWithoutPhotos", "order_date": "2026-10-24T11:40:27.84+00:00" }, { "condition": "Moderately Played", "variant": "Holofoil", "language": "English", "quantity": 1, "purchase_price": 399.97, "shipping_price": 0, "listing_type": "ListingWithoutPhotos", "order_date": "2026-10-23T14:24:34.207+00:00" }, { "condition": "Lightly Played", "variant": "Holofoil", "language": "English", "quantity": 1, "purchase_price": 565, "shipping_price": 0, "listing_type": "ListingWithPhotos", "order_date": "2026-10-23T04:25:53.693+00:00" } ] } } ```