TCGplayer Product Search API

Endpoint facts

Method

GET

API path

/tcgplayer/search

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

TCGplayer

Response schema

#/definitions/tcgplayer.searchResponseDoc

How this endpoint behaves

Parameters:

• q (optional when product_line is set): the search text, up to 100 characters.
• product_line (optional): restrict to one product line by its url_name from tcgplayer-product-lines (pokemon, magic, yugioh, one-piece-card-game, ...). An unknown value returns 400.
• set (optional, needs product_line): restrict to one set by its url_name from tcgplayer-sets. An unknown value returns 400.
• product_type, rarity, card_type (optional): exact labels, for example Cards, Booster Box, Holo Rare, Pokemon. The labels in use for the current search are returned in facets. They differ by product line.
• min_price, max_price (optional): bounds on the market price in US dollars.
• sort (optional): one of market-price, lowest-price, lowest-price-with-shipping, median-price, listings, sales, product-name. Omit it for relevance.
• order (optional, needs sort): asc or desc. The default is desc, except asc for product-name.
• limit (optional): page size, 1 to 50; defaults to 24.
• offset (optional): results to skip; offset plus limit must be 9999 or less.

Notable response behavior:

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

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

Sampled response

Request, 26 Oct 2026

GET /tcgplayer/search?q=charizard&product_line=pokemon&limit=5

Items in products

5

Fields filled in every checked item

13

Fields empty in some or all items

4

Shared guides

Related