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

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



Current Version: 5.1.1

  Patch Version: 2.8.0.9554

   Last Updated: Jul 29, 2015(change log)



ALERT: alert message goes here


Download Card Data
(English)
AllSets.json 303.0KB
AllSets.json.zip 64.8KB
CardBacks.json 7.9KB

(All Languages)
AllSetsAllLanguages.json 4.1MB
AllSetsAllLanguages.json.zip 960.0KB
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
    }
		

Card 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.

Example Card Back(back to top)




    {
             "name" : "Fireside",

      "description" : "A generous gift from the Innkeeper.  He loves to see his guests having a good time together.",

           "source" : "Special",
       "sourceType" : "Achieve",

         "howToGet" : "Play three matches against players on the same local network as you. (Must have at least 3 players on that network!)",

          "enabled" : true,
               "id" : 4
    }
		

Card Back Documentation(back to top)

The 'CardBacks.json' file is an array where each item is an object representing a card back.

If a value would be empty, then the key will not exist in the object.

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

Key Example Description
name "Fireside" The card back name.
description A generous gift from the Innkeeper. He loves to see his guests having a good time together. A description of the card back.
source "Special" The source of this card back.
sourceType "Achieve" The type of the soure for this card back.
howToGet "Play three matches against players on the same local network as you. (Must have at least 3 players on that network!)" How to get this card back. Not always present.
id 4 The Hearthstone ID of the card back.
enabled true If this card back is enabled in the game, this is true. false otherwise.

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 Patch Version Changes
5.1.1 Jul 29, 2015 2.8.0.9554
  • Added 2 card backs
5.1.0 Jun 15, 2015 2.7.0.9166
  • Added Card Backs!
5.0.0 Jun 15, 2015 2.7.0.9166
  • Added Tavern Brawl and Hero Skins!
4.0.2 May 31, 2015 2.6.0.8834
  • Very minor changes. Two artist corrections and some debug card changes.
4.0.1 Apr 2, 2015 2.4.0.8311
  • Fixed a bug with non-breaking spaces appearing instead of regular spaces in several french cards
4.0.0 Apr 2, 2015 2.4.0.8311
  • Added Blackrock Mountain!
3.0.2 Feb 2, 2015 2.1.0.7628
  • Updated to latest patch data.
3.0.1 Dec 11, 2014 2.0.0.7234
  • Changed 'Expert' set to 'Classic' as Blizzard has done the same.
3.0.0 Dec 5, 2014 2.0.0.7234
  • Added Goblins vs Gnomes!
2.1.0 Sep 23, 2014 1.2.0.6485
  • Updated to latest patch data.
  • Added two new languages: ptPT and enGB.
2.0.0 Jul 22, 2014 1.1.0.6024
  • Added Curse of Naxxramas!
1.2.1 May 12, 2014 1.0.0.5314
  • Updated to latest patch data.
  • A few minions now correctly have a 0 cost where before their cost was missing.
1.2.0 May 2, 2014 1.0.0.5170
  • Added 'mechanics' attribute to cards.
1.1.0 May 2, 2014 1.0.0.5170
  • Added non-English languages.
1.0.0 May 1, 2014 1.0.0.5170
  • 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



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

AllSets.zhTW.json.zip



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

AllSets.enGB.json.zip



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

AllSets.enUS.json.zip



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

AllSets.frFR.json.zip



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

AllSets.deDE.json.zip



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

AllSets.itIT.json.zip



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

AllSets.koKR.json.zip



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

AllSets.plPL.json.zip



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

AllSets.ptBR.json.zip



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

AllSets.ptPT.json.zip



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

AllSets.ruRU.json.zip



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

AllSets.esMX.json.zip



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

AllSets.esES.json.zip



CardBacks.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


My Other JSON Sites(back to top)

Magic the Gatheringmtgjson.com
Heroes of the Stormheroesjson.com