Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
FREEDOM251

Freedom251 › Blog › API

How to Find a Specific Card in the Pokémon TCG Card Database: Web and API Guide

By Freedom251 Team · · 10 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The quickest way to find a particular Pokémon card is to use the official Pokémon Trading Card Game Card Database. Search the card’s name or a distinctive word from its attack or rules text, then narrow the results with advanced filters such as expansion, rarity, card type, HP, format, weakness, resistance, attack cost, or illustrator. Confirm the exact printing with the expansion icon, collector number, and rarity. For software, the documented endpoint is GET https://api.pokemontcg.io/v2/cards, where Lucene-like queries can search names, attacks, sets, legality, and numeric ranges.

This workflow matters because a Pokémon’s name can appear on many cards, while one set may contain several versions of the same Pokémon. A search result is only an identification when its set, number, rarity, and other printed details match the card you hold or the record you need.

As an Amazon Associate I earn from qualifying purchases.

Start with the official web database

Open https://www.pokemon.com/us/pokemon-tcg/pokemon-cards/. The basic search accepts a Pokémon card name or a word expected to appear in the card’s description. It can also target a specific text area, including attack descriptions or special rules, which is useful when you remember an effect but not the Pokémon’s name.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Enter the strongest clue you have. Use the Pokémon’s name when you know it. Otherwise enter a distinctive attack name, attack phrase, or special-rule wording.
  2. Review the returned cards. Compare the artwork, card name, set symbol, card number, rarity, and any visible game text with the physical card or your notes.
  3. Open advanced search when the list is broad. Add one or more filters rather than replacing the text search with a vague term.
  4. Verify the printing. Treat the expansion icon, collector number, and rarity as identification fields, not merely decorative details.

Searching by a remembered effect is often more reliable than guessing a set. A name such as “Charizard” can match many eras and rarities; a distinctive attack phrase can reduce the list before you inspect the artwork.

Use advanced filters to narrow the result

The database can combine several criteria. Add only filters that describe the card you are trying to identify; an incorrect filter can hide the right result even when the name is correct.

Filter What it helps identify Useful clue to enter
Card type Separates Pokémon cards from Trainer or Energy cards and other available categories. The kind of card printed at the top or shown in your collection record.
Pokémon energy type Narrows Pokémon by their displayed type. For example, the card’s displayed Fire, Water, or other energy type.
Rarity Separates cards with the same name but different rarity treatments. The rarity mark or rarity label associated with the card.
Pre-evolved Pokémon Finds cards by an evolution relationship when the current Pokémon name is uncertain. The earlier Pokémon shown in the evolution line.
Tournament format Limits results to cards associated with a selected format. The format relevant to your deck or legality check.
Expansion Restricts the search to a particular set. The set name or expansion symbol printed on the card.
HP Distinguishes cards with the same Pokémon name across releases. The HP number printed on the card.
Retreat cost Separates cards by the number of retreat symbols. The card’s printed retreat cost.
Total attack cost Finds attacks requiring a particular total number of Energy. Count every Energy symbol in the attack cost.
Attack-cost energy type Narrows attacks by the types of Energy they require. The Energy symbols shown beside the attack.
Weakness Finds cards with a particular weakness. The weakness type printed in the lower part of the card.
Resistance Finds cards with a particular resistance. The resistance type printed in the lower part of the card.
Card illustrator Identifies cards by the credited artist. The illustrator name printed at the bottom of the card.

Filters work best in stages. Start with the name or text, add the expansion if you recognize the set, and then use HP, rarity, illustrator, or attack-cost details to resolve the remaining candidates. If you are unsure about a value, leave that filter empty and rely on fields you can verify visually.

Know which card text can and cannot be searched

The search is built around supported card fields rather than every piece of printed information. Name, attack text, special rules, set, and the listed attributes are useful search inputs. Nonessential gameplay text is not searchable. The database specifically does not search items such as a Pokédex number, height, or weight.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If you remember only a Pokédex number, height, or weight, use that memory as a confirmation clue after you have found likely cards. Begin instead with the Pokémon name, an attack description, a special rule, the expansion, or another supported field. This prevents a valid card from being excluded simply because the remembered detail is not indexed.

Rank #2
Sale
Pokemon Trading Card Game Random Sealed 3 Booster Packs 100% Authentic
  • Collect Them All | Grow your collection.
  • Latest & Greatest | All of your packs will be from the Sword & Shield era OR NEWER! This means you have a chance to get the latest & greatest cards.
  • 100% Authentic | Coming from verified vendors, these packs are 100% authentic from The Pokemon Company. No need to worry about fake cards or resealed packs!
  • Online Code Card | Each booster pack comes with one Pokemon Trading Card Game Online (Live) Code Card!
  • Pokemon Trading Card Game Online (Live) | Free to download, free to play, online version of the Pokémon Trading Card Game. An easy way to learn how to play the Pokemon Trading Card Game!

When you remember an attack or rule

Enter a distinctive word or phrase from the attack description or special rules area. A rare verb, named condition, or unusual effect is generally more useful than a common word such as “damage.” Once results appear, compare the full attack text and Energy cost with the physical card.

When you remember only appearance

Use any text you can read first, then inspect the thumbnails and open candidate records. Artwork alone is not a reliable printing identifier because the same Pokémon can have multiple illustrations. Confirm the expansion and collector number before recording the match.

Confirm the exact printing, not just the Pokémon

Finding the right Pokémon name is only the first half of identification. The same name may be printed in multiple expansions, rarities, languages, or card treatments. Use the following fields together:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Verification field How to use it
Expansion icon Match the symbol on the card with the expansion shown in the database record.
Collector number Compare the number printed in the set numbering, including its position relative to the set’s total.
Rarity Check that the database rarity agrees with the card’s rarity mark or listing.
Card name and form Distinguish a base Pokémon from an evolved form, special form, or version with a suffix.
HP and attacks Use the printed HP, attack names, text, and Energy costs to separate otherwise similar releases.
Illustrator Confirm the credited artist when artwork or alternate printings remain ambiguous.

The expansion icon identifies the set, while the card number and rarity help distinguish printings within that set. If a card matches the Pokémon and artwork but not the collector number, treat it as a different printing until the discrepancy is explained.

Rank #3
Pokemon TCG: Mega Evolution - Chaos Rising Sleeved Booster Pack
  • Each sealed Chaos Rising Booster Pack in a cardboard guard contains 10 random cards (contents vary by product)

Troubleshoot a search that returns too many or too few cards

Too many results

  • Add the expansion when you know the set.
  • Use the card’s rarity, HP, weakness, resistance, or illustrator.
  • Search a distinctive attack or special-rule phrase instead of a generic word.
  • Add a tournament format when you are checking a format-specific card pool.
  • Use retreat cost, total attack cost, or attack-cost Energy type when those values are visible.

No results

  • Remove the least-certain filter and search the name alone.
  • Try a shorter distinctive keyword from the attack or rule text.
  • Check whether you entered a Pokédex number, height, or weight; those nonessential details are not searchable.
  • Verify the spelling of the Pokémon or set, then compare likely cards by image and printed fields.
  • Search the expansion and collector-number information separately if the name is difficult to read.

Several candidates still look identical

Open each candidate and compare the expansion icon, collector number, rarity, HP, attack text, and illustrator. The record that matches all available printed details is the useful identification. Do not choose solely by the first image or by the Pokémon name.

Search the card database from software

For a spreadsheet importer, collection tool, or repeatable lookup, the documented endpoint is GET https://api.pokemontcg.io/v2/cards. Its q parameter accepts Lucene-like syntax. You can also use page, pageSize, orderBy, and select to control the response. The documented maximum for pageSize is 250.

A practical programmatic search has four stages: submit a constrained query, inspect the returned IDs and metadata, retrieve the exact record by ID, and store the fields that prove the match.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Choose a query field. Use a name, phrase, attack name, nested set field, legality field, or numeric range.
  2. Combine constraints. Add set, HP, or another known attribute to reduce ambiguous matches.
  3. Control the response. Set a page number, choose a page size no higher than 250, and use orderBy or select when your application needs predictable output.
  4. Verify by ID. After identifying the correct result, call /v2/cards/<id> to retrieve one record and confirm its metadata.

For example, a basic request can be represented as:

GET https://api.pokemontcg.io/v2/cards?q=name:charizard&pageSize=25

URL-encode reserved characters when constructing requests in code. Keep the query itself in a configuration or test fixture so that exact searches can be reproduced.

Lucene-like query patterns that solve common lookups

Goal Query pattern What it does
Name keyword name:charizard Finds records whose name matches the keyword.
Exact name phrase name:"venusaur v" Searches the phrase as a name value.
Wildcard prefix name:char* Matches names beginning with the supplied prefix.
Exact-name exclusion syntax !name:charizard Uses the documented exact-name query form.
Set identifier set.id:sm1 Searches the nested set identifier.
Attack name attacks.name:Spelunk Finds cards with that attack name.
Legality legalities.standard:banned Filters on the Standard legality value.
HP minimum hp:[150 TO *] Finds cards with HP of 150 or higher.

Spaces can be used to add conditions in a combined query, such as a name plus a set identifier or a name plus an HP range. Build combinations from fields you can independently verify. A query that is syntactically valid but based on a guessed set code can exclude the card you need.

Example: identifying a card from partial clues

Suppose you know only that the name starts with “Char,” the card has at least 150 HP, and it belongs to set sm1. A combined query can use the documented forms name:char*, hp:[150 TO *], and set.id:sm1. Review the returned records rather than assuming the first match is correct; the final test remains the record’s name, set, number, rarity, artist, legalities, images, and any available marketplace URL field.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Use the ID lookup as the final verification step

Search results can contain several records that share a name or attack. Once your application selects a candidate ID, call /v2/cards/<id>. The single-record response is the appropriate place to verify:

Best Value
Pokémon TCG: Mega Evolution—Pitch Black Booster Bundle
  • Pokémon TCG: Mega Evolution—Pitch Black Booster Bundle contains six booster packs from Pokémon TCG: Mega Evolution—Pitch Black.
  • This is a great option for getting into the new Choas Rising expansion.
  • A great gift for the Pokémon collector or player in your life.
  • the card name and form;
  • the set and collector number;
  • rarity and artist;
  • legalities;
  • image URLs;
  • any marketplace URL field returned by the record.

Store the ID with your collection entry. Names can recur across expansions, but the ID gives your software a stable reference to the particular database record you inspected.

API status and maintenance considerations

The current API documentation describes the Pokémon TCG API as deprecated. New account registrations are unavailable, while existing keys are documented to continue through March 1, 2027. The documentation advises migration to Scrydex.

That status changes how you should build an integration. For a one-off lookup, the web database may be the simplest and least fragile option. For an existing application, keep the API behind a small adapter so query construction, pagination, field selection, and ID retrieval can be replaced without rewriting the rest of your code. Before deploying a new dependency, verify that your access method and key remain available and make a migration plan rather than treating the legacy endpoint as a permanent service.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Web database or API: choose by the task

Need Official web database Documented API
One or a few manual searches Enter a name or card-text keyword and refine with visible filters. Requires constructing a request and parsing the response.
Advanced field filtering Offers filters for type, Energy type, rarity, evolution, format, expansion, HP, retreat cost, attack cost, weakness, resistance, and illustrator. Supports fielded, nested-field, wildcard, phrase, exclusion, legality, and numeric-range queries.
Exact printing confirmation Compare expansion icon, collector number, rarity, artwork, and printed text directly. Retrieve one record by ID and inspect set, number, rarity, artist, images, and legalities.
Large or repeatable retrieval Designed for interactive use. Supports page, pageSize up to 250, orderBy, and select.
Long-term maintenance Use the current official site for manual identification. Plan for migration because the documented service is deprecated and existing keys are stated to continue through March 1, 2027.

Record the result so you can find it again

After identifying a card, save its name, expansion, collector number, rarity, illustrator, and database ID when you used the API. For a physical collection, those fields are more useful than a note that says only “Pikachu,” because they distinguish alternate printings.

A binder or collection album is optional organizational help after identification; it is not required to search the database. If you later need a purchase or market reference, use the identified record first. The API documentation demonstrates TCGplayer URL fields, but the presence of a URL does not establish an affiliate relationship, a commission, or a currently available listing.

Quick Recap

SaleBestseller No. 2
Pokemon Trading Card Game Random Sealed 3 Booster Packs 100% Authentic
Pokemon Trading Card Game Random Sealed 3 Booster Packs 100% Authentic
Collect Them All | Grow your collection.
$23.25
Bestseller No. 5
Pokémon TCG: Mega Evolution—Pitch Black Booster Bundle
Pokémon TCG: Mega Evolution—Pitch Black Booster Bundle
This is a great option for getting into the new Choas Rising expansion.; A great gift for the Pokémon collector or player in your life.

A repeatable identification checklist

  1. Open the official Pokémon TCG Card Database.
  2. Search the Pokémon name, attack text, or special-rule text you actually remember.
  3. Discard unsupported clues such as Pokédex number, height, or weight as search terms.
  4. Add expansion, rarity, type, format, HP, retreat cost, attack cost, weakness, resistance, or illustrator filters only when you can verify them.
  5. Compare the candidate’s image and printed text with your card.
  6. Confirm the expansion icon, collector number, and rarity.
  7. If automating, reproduce the search with a documented q expression and retrieve the selected ID through /v2/cards/<id>.
  8. Save the identifying fields and the ID, then note the API’s deprecation and March 1, 2027 key-continuity date if your software depends on it.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

APIcard databasecard searchPokémon cardsPokémon TCG

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.