Andrew Backes

Pokémon TCG API

From Base Set to the most recent cards, the Pokémon TCG API is the ultimate Pokémon TCG developer resource.

https://pokemontcg.io

Overview

The Pokémon TCG API is a free, simple to use API that delivers Pokémon card and set data in JSON.

The API is written in Ruby on Rails, while the data is all stored in PostgreSQL.

This project was created after noticing a gap in developer resources for those interested in creating Pokémon TCG related applications. There were a few card search websites out there, but none of them made their data available so that others could use it as well. This API provides an easy way to access all card data including hi-res images. Users are able to make edits to the data themselves via the following github repo: https://github.com/PokemonTCG/pokemon-tcg-data.

Here is a sample requests/response:

GET https://api.pokemontcg.io/v1/cards/base1-2

{
   "card":{
      "id":"base1-2",
      "name":"Blastoise",
      "nationalPokedexNumber":9,
      "imageUrl":"https://images.pokemontcg.io/base1/2.png",
      "imageUrlHiRes":"https://images.pokemontcg.io/base1/2_hires.png",
      "types":[
         "Water"
      ],
      "supertype":"Pokémon",
      "subtype":"Stage 2",
      "evolvesFrom":"Wartortle",
      "ability":{
         "name":"Rain Dance",
         "text":"As often as you like during your turn (before your attack), you may attach 1 Water Energy Card to 1 of your Water Pokémon. (This doesn't use up your 1 Energy card attachment for the turn.) This power can't be used if Blastoise is Asleep, Confused, or Paralyzed.",
         "type":"Pokémon Power"
      },
      "hp":"100",
      "retreatCost":[
         "Colorless",
         "Colorless",
         "Colorless"
      ],
      "convertedRetreatCost":3,
      "number":"2",
      "artist":"Ken Sugimori",
      "rarity":"Rare",
      "series":"Base",
      "set":"Base",
      "setCode":"base1",
      "attacks":[
         {
            "cost":[
               "Water",
               "Water",
               "Water"
            ],
            "name":"Hydro Pump",
            "text":"Does 40 damage plus 10 more damage for each attached to Blastoise but not used to pay for this attack's Energy cost. Extra Energy after the 2nd doesn't count.",
            "damage":"40+",
            "convertedEnergyCost":3
         }
      ],
      "weaknesses":[
         {
            "type":"Lightning",
            "value":"×2"
         }
      ]
   }
}

Future Plans

Currently, version 2 of the API is being designed and developed. It will introduce quite a few performance boosts and will completely change the tech stack.

The future stack includes:

  • .NET Core
  • Azure Search
  • Azure Functions

Check It Out