HearthstoneJSON

JSON files for Hearthstone

A HearthSim project

The API is available at api.hearthstonejson.com/v1/

The files are all in JSON format, encoded in UTF-8 and categorized by build, then by locale.

The /v1/latest/ endpoint redirects (302) to whichever build is the latest one.

All files are automatically converted from the game files, made available in the hs-data repository.


Changelog

Changes since legacy API:

  • Website:
    • New website style and theme!
    • API now has its own subdomain and is served with HTTPS
    • API is now versioned (/v1/)
    • Separate output for each build. /v1/latest/ will always give you the latest build.
    • Locales are now generated into their own directory
    • Zip support has been removed in favour of server compression
  • Cards:
    • CardSet separation has been removed as it was largely unused
    • Tags are not localized anymore (mostly this just means uppercased)
    • Created separate “collectible” set
    • Added individual set and targetingArrowText properties
    • Added some more mechanics (forgetful, treasure…)
    • Added entourage property
    • Added playRequirements property
    • Added `dust property
  • Card backs:
    • Added more properties from the DBF

Card objects

See full card documentation.

Example card:

Leeroy Jenkins

{
	"id": "EX1_116",
	"name": "Leeroy Jenkins",
	"text": "<b>Charge</b>. <b>Battlecry:</b> Summon two 1/1 Whelps for your opponent.",
	"rarity": "LEGENDARY",
	"type": "MINION",
	"cost": 5,
	"attack": 6,
	"health": 2,
	"collectible": true,
	"set": "EXPERT1",
	"faction": "ALLIANCE",
	"artist": "Gabe from Penny Arcade",
	"flavor": "At least he has Angry Chicken.",
	"mechanics": [
		"BATTLECRY",
		"CHARGE"
	],
	"dust": [
		1600,
		3200,
		400,
		1600
	]
}

Card Back objects

See full card back documentation.

Example card back:

{
	"description": "A generous gift from the Innkeeper.  He loves to see his guests having a good time together.\\n\\nPlay three matches against players on the same local network as you. (Must have at least 3 players on that network!)",
	"name": "Fireside",
	"prefab_name": "Assets/Game/CardBacks/Launch/Card_Back_Launch",
	"note_desc": "Fireside",
	"source": "achieve",
	"id": 4,
	"enabled": true,
	"source_description": "Special"
}

Support

HearthstoneJSON is a HearthSim project and is available on GitHub.