Skip to content
pokemontcgapi.com

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/status when 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.

Talk to us