Docs / API reference

Search cards

Find cards by name, set, game or collector number. Results don't include prices; use the card_id to get them.

Request

GEThttps://tcgpriceapi.com/v1/cards

Name	Type	Description
`name`	string	Part of the card's name, at least 2 characters. Not case sensitive.
`set`	string	The exact set name, as listed by /v1/sets.
`game`	string	The exact game name, such as `Pokemon` or `Magic: The Gathering`.
`number`	string	The collector number printed on the card, such as `4/102`, `OP01-001` or `025/165`. Not case sensitive. Leading zeros and the "/total" part are optional, so `4`, `004` and `4/102` all find a card numbered `004/102`.
`limit`	integer	How many cards to return, 1 to 100. Defaults to 50.
`offset`	integer	How many cards to skip, for paging, up to 100,000. Defaults to 0. To go further, narrow the search.

Counts as one request.

Request

curl "https://tcgpriceapi.com/v1/cards?game=Pokemon&name=charizard&limit=2" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://tcgpriceapi.com/v1/cards?game=Pokemon&name=charizard&limit=2",
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://tcgpriceapi.com/v1/cards?game=Pokemon&name=charizard&limit=2", {
  headers: { "X-API-Key": process.env.TCGPRICEAPI_KEY },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

Response

Response 200

[
  {
    "card_id": "card_20391f2e09144825",
    "name": "Charizard",
    "set": "Arceus",
    "number": "1/99",
    "rarity": "Holo Rare",
    "game": "Pokemon",
    "image_url": "https://tcgplayer-cdn.tcgplayer.com/product/84191_in_1000x1000.jpg"
  },
  {
    "card_id": "card_1c3aaea45434413c",
    "name": "Charizard",
    "set": "Base Set",
    "number": "004/102",
    "rarity": "Holo Rare",
    "game": "Pokemon",
    "image_url": "https://tcgplayer-cdn.tcgplayer.com/product/42382_in_1000x1000.jpg"
  }
]

Field	Type	Description
`card_id`	string	Our permanent ID for this card.
`name`	string	The card's name.
`set`	string	The set the card is from.
`number`	string or null	The card's number in its set.
`rarity`	string or null	The card's rarity.
`game`	string	The game.
`image_url`	string	A link to a picture of the card.