Hearthstone JSON

This project provides up to date Hearthstone card data in JSON format for developers to easily use in their projects.

For more details see: Example Card and Documentation and Reddit Thread

Any bugs or feedback, e-mail me at robert@cosmicrealms.com



Current Version: 2.1.0

  Patch Version: 1.2.0.6485

   Last Updated: Sep 23, 2014(change log)



ALERT: alert message goes here


Download Card Data
(English)
AllSets.json 206.7KB
AllSets.json.zip 44.7KB

(All Languages)
AllSetsAllLanguages.json 2.8MB
AllSetsAllLanguages.json.zip 657.7KB
Individual Sets and Other Languages


Example Card(back to top)


    {
             name : "Leeroy Jenkins",

             cost : 5,

             type : "Minion",
           rarity : "Legendary",
          faction : "Alliance",

             text : "Charge. Battlecry: Summon two 1/1 Whelps for your opponent.",
        mechanics : ["Battlecry", "Charge"],

           flavor : "At least he has Angry Chicken.",

           artist : "Gabe from Penny Arcade",

           attack : 6,
           health : 2,

      collectible : true,
               id : "EX1_116",
            elite : true
    }
		

Documentation(back to top)

All JSON files are UTF8 encoded and may contain UTF8 characters.

The 'AllSets.json' file is an object where each key is the set name and the value is an array of the cards in that set.

Each individual set file is a JSON array of the cards cards in that set.

Each card is a JSON object with key/value pairs. Below you will find a table detailing each key.

The cards are sorted by 'name'

If a value would be empty (such as playerClass for Neutral cards), then the key will not exist in the object.

All card data is extracted directly from the Hearthstone game files.

Key Example Description
name "Leeroy Jenkins" The card name.
cost 4 The mana cost of this card.
type "minion" The card type. Example values: Minion, Spell, Weapon, Hero, Hero Power, Enchantment
rarity "Legendary" The rarity of the card. Example values: Free, Common, Rare, Epic, Legendary
Note: Hearthstone internally uses 'Common' rarity on several cards in the Basic set that are obtained for free.
      Thus these cards show a 'Common' rarity even though the player gets them freely.
faction "Alliance" The faction of the card. Example values: Alliance, Horde, Neutral
race "Beast" The race of the card. Example values: Murloc, Demon, Beast, Totem, Pirate, Dragon
playerClass "Mage" The player class this card belongs to. Example values: Druid, Hunter, Mage, Paladin
text "<b>Enrage:</b> +3 Attack" The text of the card when it is in your hand. May contain HTML tags and other symbols which are present in the Hearthstones files as presented here.
inPlayText "For the Alliance!" The text of the card when it is in play. May contain HTML tags and other symbols which are present in the Hearthstones files as presented here.
mechanics ["Battlecry", "Charge"] The mechanics of the card. Example values: Windfury, Combo, Secret, Battlecry, Deathrattle, Taunt
flavor "Always roll need." The flavor text of the card.
artist "Gabe from Penny Arcade" The artist of the card.
attack 6 The attack of the card. Used for both Minions and Weapons.
health 2 The health of the card. Used for Minions.
durability 3 The durability of the card. Used for Weapons.
id "EX1_116" The Hearthstone ID of the card.
collectible true If this card can be acquired by the player, this is true. false otherwise.
elite true Whether or not this card is elite.
howToGet "Unlocked at Level 1." How to get this card. Only present if it's gotten via a method other than opening a booster pack.
howToGetGold "Unlocked at Level 40." How to get the gold version of this card. Only present if it's gotten via a method other than opening a booster pack.

Additional JSON Files(back to top)

These JSON files are updated whenever card data is added or updated:




Change Log(back to top)

Version Date Changes
2.1.0 Sep 23, 2014
  • Updated to patch 1.2.0.6485
  • Added two new languages: ptPT and enGB
2.0.0 Jul 22, 2014
  • Added Curse of Naxxramas!
1.2.1 May 12, 2014
  • Updated to patch 1.0.0.5314
  • A few minions now correctly have a 0 cost where before their cost was missing
1.2.0 May 2, 2014
  • Added 'mechanics' attribute to cards.
1.1.0 May 2, 2014
  • Added non-English languages.
1.0.0 May 1, 2014
  • First release!

Individual Sets and Other Languages(back to top)

Individual Sets and Other Languages
Language All Sets Individual Sets
Chinese (China) AllSets.zhCN.json

AllSets.zhCN.json.zip
Chinese (Taiwan) AllSets.zhTW.json

AllSets.zhTW.json.zip
English (Great Britain) AllSets.enGB.json

AllSets.enGB.json.zip
English (United States) AllSets.enUS.json

AllSets.enUS.json.zip
French (France) AllSets.frFR.json

AllSets.frFR.json.zip
German (Germany) AllSets.deDE.json

AllSets.deDE.json.zip
Italian (Italy) AllSets.itIT.json

AllSets.itIT.json.zip
Korean (South Korea) AllSets.koKR.json

AllSets.koKR.json.zip
Polish (Poland) AllSets.plPL.json

AllSets.plPL.json.zip
Portuguese (Brazil) AllSets.ptBR.json

AllSets.ptBR.json.zip
Portuguese (Portugal) AllSets.ptPT.json

AllSets.ptPT.json.zip
Russian (Russia) AllSets.ruRU.json

AllSets.ruRU.json.zip
Spanish (Mexico) AllSets.esMX.json

AllSets.esMX.json.zip
Spanish (Spain) AllSets.esES.json

AllSets.esES.json.zip

License and Copyright(back to top)

Card names and text are all copyright Blizzard Entertainment.

This website is not affiliated with Blizzard Entertainment in any way.

I am providing the JSON files under the public domain license.


Source Code(back to top)

Source code used to generate the JSON is available here: https://github.com/Sembiance/hearthstonejson