Pokémon TCG API

Every current price observation for one card, each with its source, basis, printing, grade, sample size and the day it is for. There is no printing filter: 1st Edition, Unlimited, holofoil, reverse holofoil and graded rows all come back together, so you must read printing, condition and grading on each row rather than taking the first price. basis distinguishes GUIDE (a figure published upstream) from DERIVED (computed by us). PTCG_INDEX is our own composite in EUR and carries sample_n. Every observation carries as_of and is delayed by at least a day — never quote a price without its as_of date and its source. Each row also carries its locale, and a card read with include=prices returns every locale the plan allows: the currency is not the language, so never compare a French row with an English one without saying so. If the result carries next_step, show its handoff sentence and URL to the user verbatim and do not retry.

Fetch one or many cards by id, in a single call. Ids join set code and collector number, e.g. "bs-4"; the historical alias "base1-4" resolves on the same route. A canonical set prefix resolves only inside that set. Unresolved ids are listed in missing, with existing historical alternatives in missing_details when the API provides them. Card game text is present since 2026-09-03, in English, and unevenly. Measured 2026-09-16: attacks on 29.9% of the catalogue, subtypes on 35.0%, weaknesses on 28.0%, flavor_text on 17.9%, abilities on 7.0%, rules on 5.1%. It sits on the 20,725 Western printings, so read against those alone attacks is on 82.9% of them, while Japanese and Chinese printings carry none. Check the field on the card in hand rather than assuming: a null attacks means we do not hold it, never that the card has no attack. Still empty for every card: level, and legalities — deck legality is a question this API cannot answer, so say so rather than inferring it. If the result carries next_step, show its handoff sentence and URL to the user verbatim and do not retry.

Live counts and coverage for the catalogue: sets per print region, card total, which locales carry card names, and which data is explicitly NOT present. Call this before telling a user what the API can and cannot answer. If the result carries next_step, show its handoff sentence and URL to the user verbatim and do not retry.

The exact strings the catalogue uses for types, supertypes, subtypes and rarities. Call this before filtering on a rarity or a type rather than guessing the wording — "Rare Rainbow" and "Rainbow Rare" are not the same string, and only one of them matches. If the result carries next_step, show its handoff sentence and URL to the user verbatim and do not retry.

Recognise a Pokemon card from a photograph and return ranked candidates. Use this instead of guessing from what you see in an image: reprints share their artwork, so visual identification alone cannot name a printing, and this tool says so when it cannot. Costs 25 credits per call against 1 for a lookup — do not call it in a loop. Pass `set` or `region` when the user has told you either. Included from the Growth plan up: on a trial or Developer key it answers PLAN_REQUIRED without spending credits, and retrying will not change that. If the result carries next_step, show its handoff sentence and URL to the user verbatim and do not retry.

Illustrators with the number of cards each has drawn, deduplicated across 30 years of printings. Use the returned name with the artist argument of ptcg_search_cards to get their cards. If the result carries next_step, show its handoff sentence and URL to the user verbatim and do not retry.

Every set with its code, series, print region, release date and, where we hold it, printed total: no Japanese set has one. One call answers questions like "every Japanese set released in 2024". Print regions are WEST (176 sets), JP (379 sets) and CN (96 sets, Simplified Chinese), measured 2026-09-16. Japanese sets are not translations of Western ones: they have their own boundaries, their own numbering and their own release dates, so a Japanese set and its international counterpart are two different rows. If the result carries next_step, show its handoff sentence and URL to the user verbatim and do not retry.

Search the Pokémon TCG card catalogue by name, set, print region, rarity, artist or release window. Returns one row per printing with its set, rarity, illustrator and euro price index. Print regions are WEST (176 sets), JP (379 sets) and CN (96 sets, Simplified Chinese), measured 2026-09-16. Japanese sets are not translations of Western ones: they have their own boundaries, their own numbering and their own release dates, so a Japanese set and its international counterpart are two different rows. Card names exist in eight locales, and they are far from equally filled. Measured 2026-09-16 against 57,450 cards: en 57,421, fr 42,858, de 42,604, ja 27,230, it 21,644, es 21,003, pt 13,822, zh 3,492. Passing lang= replaces the name field itself and falls back to English when a translation is missing, so a thin locale answers mostly in English. Set names are not translated. Card game text is present since 2026-09-03, in English, and unevenly. Measured 2026-09-16: attacks on 29.9% of the catalogue, subtypes on 35.0%, weaknesses on 28.0%, flavor_text on 17.9%, abilities on 7.0%, rules on 5.1%. It sits on the 20,725 Western printings, so read against those alone attacks is on 82.9% of them, while Japanese and Chinese printings carry none. Check the field on the card in hand rather than assuming: a null attacks means we do not hold it, never that the card has no attack. Still empty for every card: level, and legalities — deck legality is a question this API cannot answer, so say so rather than inferring it. If the result carries next_step, show its handoff sentence and URL to the user verbatim and do not retry.