Skip to content

Pokémon TCG card search ​

The search box on the Pokémon TCG Cards page and in the deck builder understands a small query language. A plain word is enough to find a card by name, and fields let you ask for things like "Water Pokémon with 120 HP or more" in one line: t:water hp>=120.

How search works ​

Type a query into the search box on the Cards page or in the deck builder. A query is one or more terms separated by spaces, and a card has to match every term.

  • A plain word searches card names and rules text: draw.
  • field:value searches one field: t:spell. Every field has a full name and usually a short alias, so type:spell and t:spell are the same search. Field names and values ignore upper and lower case unless this page says otherwise.

The fields, shortcuts and examples for this game are further down the page.

Matching text ​

How you write a value decides how strictly it has to match.

You typeIt matches
wordNames close to word, typos allowed, plus any card whose name or rules text contains word.
n:wordNames close to word, typos allowed.
"two words"Names or rules text containing exactly two words. Quotes turn typo tolerance off and let a value hold spaces.
field:"two words"That field contains exactly two words.
field:!valueThat field is exactly value, not just containing it.
field:/pattern/That field matches a regular expression, ignoring case: n:/^the / finds names starting with "The".

Some details:

  • Only names are typo-tolerant. Every other field matches when its value contains what you typed, so o:draw finds "draws" and "Draw 1".
  • Best matches come first. When a query has a plain word or a n: term, the closest names are listed first. A query with only fields keeps the page's normal order, and a sort you pick yourself always wins.
  • Use ! and /…/ with a field. On a plain word they compare against a card's name and rules text all at once, which rarely matches.
  • The word or is special (see below). To search for it, quote it: "or".

Combining terms ​

You typeIt means
a bBoth a and b must match.
a or bEither a or b must match. OR works too.
-aLeave out cards that match a. Works before any term or group: -t:spell, -(a or b).
(a or b) cParentheses group terms: c plus either a or b.
a b or cTerms next to each other are joined first, so this is (a b) or c. Add parentheses if not.

Comparing numbers and ranks ​

Number fields such as cost take a comparison:

OperatorMeaningExample
:Has this value: contains for text and values, equal for numberscost:3
=Equal tocost=3
!=Not equal tocost!=3
<Less thancost<3
<=Less than or equal tocost<=3
>Greater thancost>3
>=Greater than or equal tocost>=3

A field whose allowed values are listed in order, such as rarity, can be compared the same way: r>=rare finds Rare and everything ranked above it in the list shown in the fields table. A value that is not in that list never matches a comparison, though it still matches with :.

Shortcut syntax ​

is:name finds a whole kind of card in one term. not:name is the same as -is:name. If a shortcut's name has a space, quote it: is:"two words". Each game's shortcuts are listed below.

A field or shortcut the game doesn't have matches no cards, so check the spelling if a search comes back empty.

Field kinds ​

KindHow it matches
TextFree text, such as a name or rules text. : means contains (names also allow typos).
ValueOne of a set of values, such as a type or region. : means contains, so part of a value is enough. When the allowed values are listed, comparisons follow their order.
NumberA number. : means equal, and every comparison operator works.
Cost symbolsA cost written as a number (the total) or as symbols (the exact mix). See the cost section on this page.

Fields ​

FieldAliasesKindDescriptionValues
namenTextThe card's name. Unquoted text is typo-tolerant.Any text
texto, oracleTextRules text, plus the names and text of abilities and attacks.Any text
typetValueA Pokémon's energy type. Trainers have none.Grass, Fire, Water, Lightning, Psychic, Fighting, Darkness, Metal, Fairy, Dragon, Colorless
rarityrValuePrinted rarity. Comparisons use the order of the allowed values; any other rarity never matches a comparison.Common, Uncommon, Rare, Double Rare, Ultra Rare, Illustration Rare, Special Illustration Rare, Hyper Rare
seteValueSet code, such as sv1 or sm11.Values come from the card catalog.
costattackcost, energy, mv, cmcCost symbolsAttack cost. A number compares the total energy of the card's cheapest attack; energy symbols match the exact typed cost of any one attack.A number, or cost symbols
hpNumberHit points.A number
damagedmgNumberHighest printed base damage among the card's attacks. A + or × after the number is ignored.A number
stageValueEvolution stage. final matches Pokémon that do not evolve any further, on pages that load the whole card pool.Basic, Stage 1, Stage 2, Final
retreatNumberRetreat cost, as a number of energy.A number
weaknessweakValueThe energy type the card is weak to.Grass, Fire, Water, Lightning, Psychic, Fighting, Darkness, Metal, Fairy, Dragon, Colorless
regmarkregValueRegulation mark letter. Comparisons use the order of the allowed values.A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
subtypeTextAny subtype, ignoring case: Supporter, Item, Stadium, Pokémon Tool, ex, V and so on.Any text

t: is a Pokémon's energy type, not its card type. To find Trainers by kind, search the subtype: subtype:supporter, subtype:item, subtype:stadium, subtype:"pokémon tool".

Shortcuts ​

ShortcutFinds
is:exPokémon ex (the modern, lowercase mechanic).
is:vPokémon V.
is:vmaxPokémon VMAX.
is:vstarPokémon VSTAR.
is:v-unionPokémon V-UNION.
is:gxPokémon-GX.
is:EXPokémon-EX (the older, uppercase mechanic). Type it in capitals: is:ex finds the modern mechanic.
is:breakPokémon BREAK.
is:radiantRadiant Pokémon.
is:"prism star"Prism Star cards.
is:"ace spec"ACE SPEC cards.
is:megaMega Evolution Pokémon.
is:teraTera Pokémon.
is:ancientAncient cards.
is:futureFuture cards.
is:"fusion strike"Fusion Strike cards.
is:"single strike"Single Strike cards.
is:"rapid strike"Rapid Strike cards.
is:"tag team"TAG TEAM cards.
is:"ultra beast"Ultra Beasts.
is:"team plasma"Team Plasma cards.
is:spPokémon SP.
is:"delta species"Delta Species Pokémon.

is:ex and is:EX are different shortcuts: lowercase finds the modern Pokémon ex, capitals find the older Pokémon-EX. The subtype field ignores case, so subtype:ex finds both.

Attack cost ​

cost (also energy, attackcost, mv or cmc) reads a card's attacks in two ways, depending on what you type.

A number compares the total energy of the card's cheapest attack, of any type: cost:1 finds cards whose cheapest attack costs one energy, and cost<=2 finds cards with an attack for two or less.

Energy symbols describe the exact mix of energy an attack costs. Write each symbol once per energy (RCC) or put a count in front (1R2C); both mean one Fire and two Colorless. Symbols are capital letters, so cost:rcc finds nothing. For a full energy name, use braces: cost:{Fire}{Colorless}.

With symbols, cost: matches any one cost on the card that is exactly the listed mix.

SymbolMeaning
RFire
WWater
LLightning
GGrass
PPsychic
FFighting
DDarkness
MMetal
YFairy
NDragon
CColorless

A * stands for one energy of any type, so cost:RR* finds attacks costing two Fire plus any one more energy.

With symbols, the comparison operators compare the mix rather than a number:

You typeIt finds an attack whose cost is
cost:RCCExactly one Fire and two Colorless.
cost=RCCThe same: exactly one Fire and two Colorless.
cost>=RCCAt least one Fire and two Colorless, possibly with more energy.
cost>RCCAt least one Fire and two Colorless, with at least one more energy.
cost<=RCCMade only of energy from the list: R, C, RC and RCC all count.
cost<RCCMade only of energy from the list, and smaller than the whole list.
cost!=RCCAnything except exactly one Fire and two Colorless.

A card matches when any one of its attacks fits, so -cost>=R leaves out every card with an attack that needs Fire.

Examples ​

QueryFinds
t:water hp>=120Water Pokémon with 120 HP or more.
is:ex t:fireFire Pokémon ex.
subtype:supporter o:"search your deck"Supporters that search your deck.
cost:RCCPokémon with an attack that costs exactly one Fire and two Colorless.
cost>=RR damage>=200Pokémon with an attack needing at least two Fire, and an attack printed for 200 or more (not necessarily the same one).
cost:1 damage>=60Pokémon whose cheapest attack costs one energy and that have an attack printed for 60 or more.
retreat=0 stage:basicBasic Pokémon with free retreat.
stage:2 weakness:fightingStage 2 Pokémon weak to Fighting.
pkachuPikachu cards, despite the typo.
is:"ace spec"ACE SPEC cards.
not:ex t:psychic stage:basic reg:hBasic Psychic Pokémon with regulation mark H that are not Pokémon ex.

Turny.gg documentation