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: 4.0.1

  Patch Version:

   Last Updated: Apr 2, 2015(change log)

ALERT: alert message goes here

Download Card Data
AllSets.json 291.4KB
AllSets.json.zip 62.4KB

(All Languages)
AllSetsAllLanguages.json 3.9MB
AllSetsAllLanguages.json.zip 923.4KB
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
4.0.1 Apr 2, 2015
  • Fixed a bug with non-breaking spaces appearing instead of regular spaces in several french cards
4.0.0 Apr 2, 2015
  • Added Blackrock Mountain!
3.0.2 Feb 2, 2015
  • Updated to patch
3.0.1 Dec 11, 2014
  • Changed 'Expert' set to 'Classic' as Blizzard has done the same.
3.0.0 Dec 5, 2014
  • Added Goblins vs Gnomes!
2.1.0 Sep 23, 2014
  • Updated to patch
  • 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
  • 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

Chinese (Taiwan) AllSets.zhTW.json

English (Great Britain) AllSets.enGB.json

English (United States) AllSets.enUS.json

French (France) AllSets.frFR.json

German (Germany) AllSets.deDE.json

Italian (Italy) AllSets.itIT.json

Korean (South Korea) AllSets.koKR.json

Polish (Poland) AllSets.plPL.json

Portuguese (Brazil) AllSets.ptBR.json

Portuguese (Portugal) AllSets.ptPT.json

Russian (Russia) AllSets.ruRU.json

Spanish (Mexico) AllSets.esMX.json

Spanish (Spain) AllSets.esES.json


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