About
About pokemontcgapi
pokemontcgapi.com is an independent REST API for the Pokémon Trading Card Game: the catalogue of cards, sets and sealed products, dated price observations, and card recognition from a photo. It is unofficial, documented in public and priced in euro.
- Service
- A REST API over HTTPS, JSON only, one X-Api-Key header and one /v1 prefix.
- Public since
- 17 August 2026, the date of the first entry in the public changelog.
- Catalogue
- 58,481 cards, 653 sets, 2,394 sealed products and 410 illustrators, read from GET /v1/status when this page was built.
- Languages and regions
- Card names in 8 locales (en · fr · de · ja · it · es · pt · zh); three print regions: international, Japanese and Simplified Chinese.
- Prices
- Dated observations in EUR · USD, each carrying its source, basis, condition, printing and grade.
- Tooling
- OpenAPI 3.1, TypeScript and Python and Go SDKs, and the MCP server @pokemontcgapi/mcp.
- Contact
- riccardo (at) rarebit.app
- Page last reviewed
- 30 October 2026
What the API is
Three things, each read through the same key and the same envelope.
A catalogue. Every card, set and sealed product the service carries, with names in several locales, images, illustrators, regulation marks and the link between a Western printing and its Japanese counterpart where one is recorded. The coverage page prints each figure next to the request that produced it, and GET /v1/status returns the live counts.
Price observations. A quote is a dated fact with a source, a currency, a basis, a condition, a printing and a grade, never an anonymous number. The price methodology explains every source, how old a figure is when served, and how the composite euro index is computed.
Recognition from a photo. One multipart request returns ranked candidate cards; a second family of routes measures centering. Both are documented on the card scanner page and in the API reference.
How it is run
The rules this site holds itself to, so that a reader can check them.
- No number is typed by hand. Catalogue counts are read from
GET /v1/statuswhen a page is built, and every published measurement carries the date and the method it was obtained with. - Prices are observations, not appraisals. Every quote names its source and date; the attribution page lists every source the API redistributes and the terms it is used under.
- The documentation describes only what is served. Planned endpoints are marked as such and kept out of the sitemap, the OpenAPI document and
llms.txt; the changelog is dated and has an Atom feed. - Keys are stored hashed. The request log keeps one line per call with the fields the privacy page lists, and nothing else.
- It is a database of facts about a game. The service is unofficial, and says so in the footer of every page.
Who is behind it
An independent team, reachable in the open.
pokemontcgapi.com is operated by an independent team. Questions, billing and data corrections go to riccardo (at) rarebit.app; the community chat is on Discord; the SDKs, the MCP server and the example bots are published on GitHub; release notes are announced on X.
Unofficial. Not produced, endorsed, supported by or affiliated with Nintendo, Creatures Inc., GAME FREAK inc. or The Pokémon Company International. Pokémon and all related marks are trademarks of their respective owners.