TCGplayer Product Details API

Endpoint facts

Method

GET

API path

/tcgplayer/product

Auth

apiKey

Credits

2 credits/request

Charged on

Successful 2xx responses only

Platform

TCGplayer

Response schema

#/definitions/tcgplayer.productResponseDoc

How this endpoint behaves

id is required: the TCGplayer product id, the number in tcgplayer.com/product/<id>. Find it with tcgplayer-search.

Notable response behavior:

• 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):

{
  "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
        }
      ]
    }
  }
}

Sampled response

Request, 26 Oct 2026

GET /tcgplayer/product?id=243172

Items in product.skus

110

Fields filled in every checked item

4

Shared guides

Related