Hearthstone API - Updated for patch: 7.0.0.15590

This Hearthstone API provides up to date Hearthstone data pulled directly from the game. It has endpoints for all the card data, including images, card backs and more.

Blizzard has not officially released any Hearthstone API's yet so I decided to make this API to fill that gap for the time being. I will update the data everytime the game data changes.

Getting Started

To access the endpoints head over to Mashape.

Mashape
Changelog

Changes 12/03/2016

  • Neutral cards playerClass property is now set to Neutral.
  • The classes set returned by the info endpoint now contains Neutral.
  • Added multiClassGroup property to cards to support Gadgetzan's tri-class cards. Example values: Grimy Goons, Jade Lotus, Kabal.
  • Added classes property to cards to support Gadgetzan's tri-class cards. Example value for a Kabal tri-class card: Mage, Priest, Warlock.
  • Removed duplicate card text.

Changes 11/30/2016

  • Updated all data for "Mean Streets of Gadgetzan" patch 7.0.0.15590.

Changes 11/11/2016

  • Updated all data for patch 6.2.0.15300.

Changes 10/20/2016

  • Updated all data for patch 6.2.0.15181.

Changes 10/03/2016

  • Updated all data for patch 6.1.3.14830.

Changes 09/15/2016

  • Updated all data for patch 6.1.1.14406.

Changes 08/09/2016

  • Updated all data for patch 6.0.0.13921.

Changes 07/26/2016

  • Updated all data for patch 5.2.2.13807.

Changes 07/16/2016

  • Updated all data for patch 5.2.0.13740.

Changes 07/12/2016

  • Updated all data for patch 5.2.0.13619.

Changes 07/06/2016

  • A list of standard and wild sets have been added to the info endpoint.

Changes 06/30/2016

  • Card set "Promotion" has been renamed to "Promo" to better represent game data.

Changes 06/01/2016

  • Updated all data for patch 5.0.0.13030.

Changes 04/24/2016

  • Updated all data for "Whispers of the Old Gods" patch 5.0.0.12574.

Changes 04/15/2016

  • Updated all data for patch 4.3.0.12266.

Changes 03/14/2016

  • Updated all data for patch 4.2.0.12051.
  • Added support for the thTH (Thailand) locale.

Changes 01/16/2016

  • Card mechanics are now returned in the correct locale.

Changes 12/19/2015

  • You can now pass 'Neutral' to the class endpoint in order to return cards that don't belong to a specific class.

Changes 12/04/2015

  • Added new Tavern Brawl data.
  • Added Thrall, Love Is in the Air, Winter Veil Wreath and Thunder Bluff card backs.
  • Durability is now properly returned as an integer instead of a string.

Changes 11/11/2015

  • Updated all data for The League of Explorers (patch 4.0.0.10833)

Changes 10/20/2015

  • Updated for patch 3.2.0.
  • Added Highmaul card back.

Changes 09/30/2015

  • Added Exodar and Power Core card backs.
  • Added new tavern brawl cards.

Changes 09/15/2015

  • Slack integration now supports --gold parameter for returning gold images.

Changes 08/18/2015

  • Added The Grand Tournament data.
  • Added Tournament Grounds card back.

Changes 08/02/2015

  • The Card Backs data has been revamped to better represent the game data.
  • Card Backs are no longer split into categories.
  • Card Backs data now includes cardBackId, name, description, source, sourceDescription, enabled, img, imgAnimated, sortCategory, sortOrder and locale.
  • Card Backs can now be requested in different locales.

Changes 07/29/2015

  • Added Darkspear and Grand Tournament card backs.
  • Moved Molten Core and Grand Tournament card backs into new category called Pre-order.

Changes 06/16/2015

  • Updated all data for patch 2.7.0.9166
  • Added new sets Hero Skins and Tavern Brawl.
  • Added Darnassus, Galaxy Gifts, Magni, Medivh and Alleria card backs.

Changes 06/08/2015

  • Info endpoint now supports the locale parameter.

Changes 05/26/2015

  • Added Card Backs endpoint.

Changes 05/05/2015

  • Added Card Search endpoint.
  • Removed image URLs from enchantments since it doesn't apply.
  • You can now request a card and have it returned in a different locale. Example: requesting Circle of Healing with ?locale=deDE will return the german version of the card. Before you were required to type the german name of the card.
Endpoints
Endpoints Description
/info Returns a list of current patch, classes, sets, types, factions, qualities, races and locales.
/cards Returns all available Hearthstone cards including non collectible cards.
/cards/{name} Returns card by name or ID. This may return more then one card if they share the same name. Loatheb returns both the card and the boss.
/cards/search/{name} Returns cards by partial name.
/cards/sets/{set} Returns all cards in a set. Example values: Blackrock Mountain, Classic.
/cards/classes/{class} Returns all the cards of a class. Example values: Mage, Paladin.
/cards/races/{race} Returns all the cards of a certain race. Example values: Mech, Murloc.
/cards/qualities/{quality} Returns all the cards of a certain quality. Example values: Legendary, Common.
/cards/types/{type} Returns all the cards of a certain type. Example values: Spell, Weapon.
/cards/factions/{faction} Returns all the cards of a certain faction. Example values: Horde, Neutral.
/cardbacks Returns a list of all the card backs.
Example Data
Leeroy Jenkins
Leeroy Jenkins
							
								[
    {
        "cardId": "EX1_116",
        "name": "Leeroy Jenkins",
        "cardSet": "Classic",
        "type": "Minion",
        "faction": "Alliance",
        "rarity": "Legendary",
        "cost": 5,
        "attack": 6,
        "health": 2,
        "text": "<b>Charge</b>. <b>Battlecry:</b> Summon two 1/1 Whelps for your opponent.",
        "flavor": "At least he has Angry Chicken.",
        "artist": "Gabe from Penny Arcade",
        "collectible": true,
        "elite": true,
        "playerClass": "Neutral",
        "img": "http://wow.zamimg.com/images/hearthstone/cards/enus/original/EX1_116.png",
        "imgGold": "http://wow.zamimg.com/images/hearthstone/cards/enus/animated/EX1_116_premium.gif",
        "locale": "enUS",
        "mechanics": [
            {
                "name": "Charge"
            },
            {
                "name": "Battlecry"
            }
        ]
    }
]
							
						
Key Description
cardId The card ID.
name The card name.
cardSet The set name.
type The card type. Example values: Minion, Spell, Weapon, Hero, Hero Power, Enchantment.
faction The faction of the card. Example values: Alliance, Horde, Neutral.
rarity The rarity of the card. Example values: Free, Common, Rare, Epic, Legendary.
cost The mana cost of this card.
attack The attack of the card.
health The health of the card.
durability The durability of the card. Used for Weapons.
text The text of the card when it is in your hand.
inPlayText The text of the card when it is in play.
flavor The flavor text of the card.
artist The artist of the card.
collectible Indicates if the card is collectible.
elite Indicates if the card is elite.
race The race of the card. Example values: Murloc, Demon, Beast, Totem, Pirate, Dragon.
playerClass The player class this card belongs to. Example values: Druid, Hunter, Mage, Paladin.
howToGet How to get this card. Only present if you can obtain this card from a method other than opening a booster pack.
howToGetGold How to get the gold version of this card. Only present if you can obtain this card from a method other than opening a booster pack.
img URL to image of the card on Hearthhead. (Note: they put a small hearthhead text in the bottom of their images.)
imgGold URL to image of the golden card on Hearthhead. (Note: they put a small hearthhead text in the bottom of their images.)
locale The locale of the card. Available locales: enUS, enGB, deDE, esES, esMX, frFR, itIT, koKR, plPL, ptBR, ruRU, zhCN, zhTW, jaJP, thTH.
mechanics The mechanics of the card. Example values: Windfury, Combo, Secret, Battlecry, Deathrattle, Taunt.
Darkspear
Darkspear
							
								[
    {
        "cardBackId": "30",
        "name": "Darkspear",
        "description": "Vol'jin's tribe, the Darkspear trolls, no longer practices cannibalism. Officially.",
        "source": "season",
        "howToGet": "Acquired from achieving Rank 20 in Ranked Play, July 2015.",
        "enabled": true,
        "img": "http://wow.zamimg.com/images/hearthstone/backs/original/Card_Back_Troll.png",
        "imgAnimated": "http://wow.zamimg.com/images/hearthstone/backs/animated/Card_Back_Troll.gif",
        "sortCategory": "5",
        "sortOrder": "0",
        "locale": "enUS"
    }
]
							
						
Key Description
cardBackId The card back ID.
name The card back name.
description The card back description.
source The card back source. Example values: achieve, season, fixed_reward.
sourceDescription The card back source description. Example values: Default, Season, Legend.
howToGet How to get this card back.
enabled Determines if this card back is enabled in-game.
img URL to image of the card back on Hearthhead. (Note: they put a small hearthhead text in the bottom of their images.)
imgAnimated URL to image of the animated card back on Hearthhead. (Note: they put a small hearthhead text in the bottom of their images.)
sortCategory The sort category of the card back. In combination with sortOrder, this is used in-game to determine the order of the card backs.
sortOrder The sort order of the card back. In combination with sortCategory, this is used in-game to determine the order of the card backs.
locale The locale of the card back. Available locales: enUS, enGB, deDE, esES, esMX, frFR, itIT, koKR, plPL, ptBR, ruRU, zhCN, zhTW, jaJP, thTH.
Slack Integration

If your interested in showing a Hearthstone card in one of your Slack channels, add the webhook below to outgoing webhooks and setup one or more trigger words.

Webhooks Description
http://hearthstoneapi.com/webhook/slack Returns card info in slack format.

To return gold images append --gold to your request. Example: card Ysera --gold.