Article Image

Hearthstone Data Resources


There are several third-party developers who have created ways for developers to gain access to the Hearthstone data in JSON format. hearthstonejson.com provides downloadable archives of the Hearthstone card data, card back data, and card data in multiple international languages. hearthstoneapi.com provides a similar service, but via a web API built using mashape . The data provided is nearly identical to other offerings, but additionally provides a REST-based query interface for filtering/sorting/searching for cards or card backs, and can support on-the-fly locale translations.

The primary difference between these two services is based around accessibility and searchability. If you are building an offline application, or do not want to require a network connection for your user to access card data, including the raw data from hearthstonejson.com is a good option. However, if you are not concerned about requiring your user to have a network connection, or need to provide an ability for the user to perform robust queries against the card database and do not want to build search/filter abilities yourself, hearthstoneapi.com may be the solution you are looking for.

Additionaly, hearthstonejson.com 's data set does not contain information for card images, whereas hearthstoneapi.com includes urls for both regular and gold versions of the cards sourced from zamimg . Because these assets are controlled by a third party, it is probably best to store copies of them within your own application instead of sourcing them from wowhead's servers.

By using either service you are beholden to their update schedule, so extracting the data from Hearthstone manually may be preferable. As Hearthstone is a Unity game , tools like disunit can be used to extract asset files. Card data is stored in an xml file, and all art and sound assets are available. An ownedcore post explains how the game constructs card renderings during gameplay. If you want to write a converter of your own, Hearthsim has a number of open source utilities for working with hearthstone data. There are several open-source projects for converting asset data to JSON, rithms/hearthstone-card-api uses python, where HearthSim/hearthstonejson use javascript.

Tidwell in Developer Resources - Nov 23, 2015