Pokémon TCG Python SDK

To use an API Key from dev.pokemontcg.io, you can either set an environment variable or configure the static RestClient instance in your code.

Option 1: Environment Variable

export POKEMONTCG_IO_API_KEY='12345678-1234-1234-1234-123456789ABC'

Option 2: RestClient Configuration

from pokemontcgsdk import RestClient
RestClient.configure('12345678-1234-1234-1234-123456789ABC')

Install the SDK using pip to wrap the Pokémon TCG API (pokemontcg.io) in your Python projects. Requires Python 3 (developed with Python 3.9).

pip install pokemontcgsdk

The Set class allows you to interact with Pokémon TCG expansion sets.

• Find by code: Use Set.find(code).
• Filter with queries: Use Set.where(q='...') (e.g., legalities.standard:legal).
• Retrieve all: Use Set.all().

from pokemontcgsdk import Set

# Find a set by code
set = Set.find('base1')

# Filter sets via query parameters
sets = Set.where(q='legalities.standard:legal')

# Get all Sets
sets = Set.all()

You can retrieve all available entries for various Pokémon TCG classifications using the .all() method on their respective classes.

from pokemontcgsdk import Type, Subtype, Supertype, Rarity

types = Type.all()
subtypes = Subtype.all()
supertypes = Supertype.all()
rarities = Rarity.all()

The Card class is the primary interface for interacting with Pokémon cards. You can find specific cards by ID, filter them using query parameters, or retrieve all cards.

• Find by ID: Use Card.find(id).
• Filter with queries: Use Card.where(q='...') with query parameters (e.g., set.name:generations supertype:pokemon).
• Pagination: Use Card.where(page=X, pageSize=Y) to fetch specific pages of data.
• Retrieve all: Use Card.all() (Note: this may take a long time).

from pokemontcgsdk import Card

# Find a card by id
card = Card.find('xy1-1')

# Filter Cards via query parameters
cards = Card.where(q='set.name:generations supertype:pokemon')

# Get all cards, but only a specific page of data
cards = Card.where(page=5, pageSize=250)

# Find all cards (will take awhile)
cards = Card.all()

The following properties are available on the Card and Set objects:

Card Properties:

• abilities, artist, ancientTrait, attacks, convertedRetreatCost, evolvesFrom, flavorText, hp, id, images, legalities, regulationMark, name, nationalPokedexNumbers, number, rarity, resistances, retreatCost, rules, set, subtypes, supertype, tcgplayer, types, weaknesses

Set Properties:

• id, images, legalities, name, printedTotal, ptcgoCode, releaseDate, series, total, updatedAt