Heroes of the Storm JSON

This project provides up to date Heroes of the Storm data in JSON format for developers to easily use in their projects.

For more details see: Example Hero and Documentation

Any bugs or feedback, please address them on the heroesjson issue tracker.



Current Version: 2.7.19

  Patch Version: 44737 [changes from last patch]

   Last Updated: Jul 22, 2016(change log)



Download JSON Data
heroes.json 445.4KB
mounts.json 34.7KB


heroes.json Documentation(back to top)

All JSON files are UTF8 encoded and may contain UTF8 characters.

The 'heroes.json' file is an array where each entry is a hero object with key/value pairs.

Below you will find a table detailing each key.

The heroes are sorted by 'name'.

All data is extracted directly from the Heros of the Storm game files.

Key Example Description
id "Nova" The internal ID of this hero.
attributeid "Nova" The internal AttributeID of this hero.
name "Nova" The name of this hero.
title "Dominion Ghost" The title of this hero.
description "Automatically cloaks while out of combat. Snipes enemies from afar, and creates Decoys of herself to fool enemies." The description of this hero.
role "Assassin" The role of this hero.
type "Ranged" The type of this hero.
gender "Female" The gender of this hero.
franchise "Starcraft" Which universe/franchise this hero comes from.
difficulty "Medium" The level of difficulty to play this hero.
releaseDate "2014-07-22" The release date for this hero. Date format: YYYY-MM-DD
icon "ui_targetportrait_hero_Nova.dds" The internal filename for the icon used for this hero.
ratings
Type: object
Key Example Description
damage 10 A rating between 1 and 10 for this hero's damage.
utility 4 A rating between 1 and 10 for this hero's utility.
survivability 2 A rating between 1 and 10 for this hero's survivability.
complexity 5 A rating between 1 and 10 for this hero's complexity.
stats
Type: object
Keys are hero/unit id's, values are objects:
Key Example Description
hp 700 The base HP for this hero.
hpPerLevel 4.5 How much additional 'hp' this hero gains per level. This is a PERCENTAGE.
hpRegen 1.457 How much 'hp' this hero regenerates per second in game.
hpRegenPerLevel 4.5 How much additional 'hpRegen' this hero gains per level. This is a PERCENTAGE.
mana 500 The base mana for this hero.
manaPerLevel 10 How much additional 'mana' this hero gains per level.
manaRegen 3 How much 'mana' this hero regenerates per second in game.
manaRegenPerLevel 0.0976 How much additional 'manaRegen' this hero gains per level.
abilities
Type: object
Keys are hero/unit id's, values are arrays of ability objects:
Key Example Description
id "NovaSnipeStorm" The internal ID of this ability.
name "Snipe" The name of the ability.
description "Deals 115 (+31 per level) damage to the first enemy hit." The description of the ability.
shortcut "Q" The default in-game shortcut key for this ability.
cooldown 10 The cooldown, in seconds, of the ability.
manaCost 65 How much mana the ability costs to use.
manaCostPerSecond 15 How much mana the ability costs to maintain per second.
aimType "Skillshot" The type of aiming used for the ability.
heroic true Present and set to true if this ability is a heroic ability.
trait true Present and set to true if this ability is a trait.
mount true Present and set to true if this ability is a mount ability.
icon "storm_ui_icon_nova_snipe.dds" The internal filename for the icon used for this ability.
talents
Type: object
Keys are the level of the talents.
Values are arrays of talent objects.
The talents are sorted in the order they appear in game.
Key Example Description
id "NovaHeroicAbilityTripleTap" The internal ID of this talent.
name "Triple Tap" The name of this talent.
description "Locks in on the target Hero, then fires 3 shots that strike the first Hero or Structure they come in contact with for 80 (+33 per level) damage each." The description of this talent.
cooldown 100 The cooldown of this talent.
prerequisite "NovaHeroicAbilityTripleTap" The prerequisite talent id needed in order to take this talent.
icon "storm_ui_icon_nova_tripletap.dds" The internal filename for the icon used for this talent.


mounts.json Documentation(back to top)

All JSON files are UTF8 encoded and may contain UTF8 characters.

The 'mounts.json' file is an array where each entry is a mount object with key/value pairs.

Below you will find a table detailing each key.

The mounts are sorted by 'name'.

All data is extracted directly from the Heros of the Storm game files.

Key Example Description
id "MoneyPig" The internal ID of this mount.
attributeid "Mpig" The internal AttributeID of this mount.
name "Piggy Bank" The name of this mount.
description "This little piggy went, "Whee whee whee!" all the way to the bank!" The description of this mount.
franchise "Heroes" Which universe/franchise this mount comes from.
releaseDate "2014-10-14" The release date for this mount. Date format: YYYY-MM-DD
productid 10072 The internal product id for this mount. Not present for all mounts.
category "Ride" The category for this mount.


Example Hero(back to top)


{
  "id": "Nova",
  "name": "Nova",
  "title": "Dominion Ghost",
  "description": "Automatically cloaks while out of combat. Snipes enemies from afar, and creates Decoys of herself to fool enemies.",
  "role": "Assassin",
  "type": "Ranged",
  "gender": "Female",
  "franchise": "Starcraft",
  "difficulty": "Medium",
  "ratings": {
    "damage": 10,
    "utility": 4,
    "survivability": 2,
    "complexity": 5
  },
  "stats": {
    "Nova": {
      "hp": 700,
      "hpPerLevel": 110,
      "hpRegen": 1.457,
      "hpRegenPerLevel": 0.2265,
      "mana": 500,
      "manaPerLevel": 10,
      "manaRegen": 3,
      "manaRegenPerLevel": 0.0976
    }
  },
  "abilities": {
    "Nova": [
      {
        "id": "NovaSnipeStorm",
        "icon": "storm_ui_icon_nova_snipe.dds",
        "manaCost": 65,
        "name": "Snipe",
        "description": "Deals 115 (+31 per level) damage to the first enemy hit.",
        "cooldown": 10,
        "aimType": "Skillshot",
        "shortcut": "Q"
      },
      {
        "id": "NovaPinningShot",
        "icon": "storm_ui_icon_Nova_PinningShot.dds",
        "manaCost": 65,
        "name": "Pinning Shot",
        "description": "Deal 40 (+10 per level) damage to an enemy and slow it by 30% for 2.25 seconds.",
        "cooldown": 12,
        "shortcut": "W"
      },
      {
        "id": "NovaHoloDecoy",
        "icon": "storm_ui_icon_nova_holodecoy.dds",
        "manaCost": 50,
        "name": "Holo Decoy",
        "description": "Create a Decoy for 5 seconds that appears to attack enemies. \nUsing this Ability does not break Cloak.",
        "cooldown": 15,
        "shortcut": "E"
      },
      {
        "id": "NovaTripleTap",
        "icon": "storm_ui_icon_nova_tripletap.dds",
        "manaCost": 100,
        "heroic": true,
        "name": "Triple Tap",
        "description": "Locks in on the target Hero, then fires 3 shots that hit the first Hero or Structure they come in contact with for 80 (+33 per level) damage each.",
        "cooldown": 100,
        "shortcut": "R"
      },
      {
        "id": "NovaPrecisionStrike",
        "icon": "storm_ui_icon_nova_orbitalstrike.dds",
        "manaCost": 100,
        "heroic": true,
        "name": "Precision Strike",
        "description": "After a 1.5 second delay, deals 300 (+35 per level) damage to enemies within an area. Unlimited range.",
        "cooldown": 60,
        "shortcut": "R"
      },
      {
        "id": "NovaPermanentCloakSniper",
        "trait": true,
        "icon": "storm_ui_icon_nova_personalcloaking.dds",
        "name": "Permanent Cloak, Sniper",
        "description": "Gain Stealth when out of combat for 3 seconds. Taking damage, attacking, or channeling reveals you.\nBasic Attack range is 20% further than other ranged Heroes, and you see 10% further than other Heroes."
      }
    ]
  },
  "talents": {
    "1": [
      {
        "id": "GenericTalentConjurersPursuit",
        "name": "Conjurer's Pursuit",
        "description": "Increases Mana Regeneration by 0.5 per second. Every 3 Regeneration Globes gathered increases this bonus by 0.25.",
        "icon": "storm_btn_d3_monk_mantraofevasion.dds"
      },
      {
        "id": "NovaMasteryPsiOpRangefinder",
        "name": "Psi-Op Rangefinder",
        "description": "Increases Snipe's range by 20% and reduces the Cooldown by 2 seconds.",
        "icon": "storm_ui_icon_nova_snipe.dds"
      },
      {
        "id": "NovaMasteryAmbushSnipe",
        "name": "Ambush Snipe",
        "description": "Increases Snipe's damage by 20% when used from Cloak or within one second of being Cloaked.",
        "icon": "storm_ui_icon_nova_snipe.dds"
      },
      {
        "id": "NovaMasteryTazerRounds",
        "name": "Tazer Rounds",
        "description": "Increases the duration of Pinning Shot's slow to 4 seconds.",
        "icon": "storm_ui_icon_Nova_PinningShot.dds"
      }
    ],
    "4": [
      {
        "id": "NovaMasteryPerfectShotSnipe",
        "name": "Perfect Shot",
        "description": "Hitting an enemy Hero with Snipe refunds 50% of the Mana cost. Killing an enemy Hero with Snipe refunds 100% of the Mana cost.",
        "icon": "storm_ui_icon_nova_snipe.dds"
      },
      {
        "id": "NovaExtendedProjection",
        "name": "Remote Delivery",
        "description": "Reduces the cooldown of Holo Decoy by 3 seconds, and increases the range by 100%.",
        "icon": "storm_ui_icon_nova_holodecoy.dds"
      },
      {
        "id": "GenericTalentGatheringPower",
        "name": "Gathering Power",
        "description": "Passively grants 5% Ability Power. Each Hero takedown increases this bonus by 2% to a maximum of 15%. This bonus Ability Power is reset to 5% on death.",
        "icon": "storm_temp_war3_btncontrolmagic.dds"
      },
      {
        "id": "GenericTalentEnvenom",
        "name": "Envenom",
        "description": "Activate to poison an enemy Hero, dealing 180 damage over 5 seconds.",
        "icon": "storm_temp_war3_btnpoisonarrow.dds",
        "cooldown": 60
      }
    ],
    "7": [
      {
        "id": "NovaMasteryExplosiveShot",
        "name": "Explosive Round",
        "description": "Snipe also deals 50% damage to enemies near the impact.",
        "icon": "storm_ui_icon_nova_snipe.dds"
      },
      {
        "id": "NovaCombatStyleOneintheChamber",
        "name": "One in the Chamber",
        "description": "After using an ability, your next Basic Attack deals 80% additional damage.",
        "icon": "storm_btn-extra_int_0.dds"
      },
      {
        "id": "NovaCombatStyleAntiArmorShells",
        "name": "Anti-Armor Shells",
        "description": "Your Basic Attacks deal 250% damage, but your Attack Speed is proportionally slower.",
        "icon": "storm_temp_btn-upgrade-terran-u238shells.dds"
      },
      {
        "id": "NovaMasteryCovertOpsPinningShot",
        "name": "Covert Ops",
        "description": "Increases the Movement Speed slow of Pinning Shot by 1% for every second that Nova is Cloaked, to a maximum of a 50% slow. Bonus fades when Nova is un-Cloaked for one second.",
        "icon": "storm_ui_icon_Nova_PinningShot.dds"
      }
    ],
    "10": [
      {
        "id": "NovaHeroicAbilityTripleTap",
        "name": "Triple Tap",
        "description": "Locks in on the target Hero, then fires 3 shots that strike the first Hero or Structure they come in contact with for 80 (+33 per level) damage each.",
        "icon": "storm_ui_icon_nova_tripletap.dds",
        "cooldown": 100
      },
      {
        "id": "NovaHeroicAbilityPrecisionStrike",
        "name": "Precision Strike",
        "description": "After a 1.5 second delay, deals 300 (+35 per level) damage in an area. Unlimited range.",
        "icon": "storm_ui_icon_nova_orbitalstrike.dds",
        "cooldown": 60
      }
    ],
    "13": [
      {
        "id": "NovaMasteryHoloDrone",
        "name": "Lethal Decoy",
        "description": "Holo Decoy now deals 25% of Nova's damage.",
        "icon": "storm_ui_icon_nova_holodecoy.dds"
      },
      {
        "id": "NovaCombatStyleAdvancedCloaking",
        "name": "Advanced Cloaking",
        "description": "While Stealthed from Permanent Cloak, your Movement Speed is increased by 25% and you heal for 1.95% of your maximum Health per second.",
        "icon": "storm_ui_icon_nova_personalcloaking.dds"
      },
      {
        "id": "NovaCombatStyleMyKill",
        "name": "Headshot",
        "description": "Reduces your Ability cooldowns by 4 seconds when you kill an enemy Hero.",
        "icon": "storm_temp_btn-upgrade-terran-infantryweaponslevel2.dds"
      },
      {
        "id": "GenericTalentSpellShield",
        "name": "Spell Shield",
        "description": "Upon taking Ability Damage, reduce that damage and further Ability Damage by 50% for 2 seconds.  Can only trigger once every 30 seconds.",
        "icon": "storm_temp_btn-ability-protoss-hardenedshields.dds"
      }
    ],
    "16": [
      {
        "id": "NovaRailgun",
        "name": "Railgun",
        "description": "Snipe penetrates through the first enemy hit and deals 50% damage to subsequent targets. Snipe cooldown is reduced by 1 second for each target hit.",
        "icon": "storm_ui_icon_nova_snipe.dds"
      },
      {
        "id": "NovaMasteryCripplingShot",
        "name": "Crippling Shot",
        "description": "Enemies hit by Pinning shot become Vulnerable, taking 25% increased damage for the duration of the slow.",
        "icon": "storm_ui_icon_Nova_PinningShot.dds"
      },
      {
        "id": "NovaMasteryDoubleFakeHoloDecoy",
        "name": "Double Fake",
        "description": "Casting Holo Decoy creates an additional Decoy at your current location.",
        "icon": "storm_ui_icon_nova_holodecoy.dds"
      },
      {
        "id": "GenericTalentOverdrive",
        "name": "Overdrive",
        "description": "Activate to increase Ability Power by 25% and Mana costs by 40% for 5 seconds.",
        "icon": "storm_btn_d3_wizard_archon.dds",
        "cooldown": 25
      }
    ],
    "20": [
      {
        "id": "NovaMasteryFastReload",
        "name": "Fast Reload",
        "description": "Triple Tap's cooldown is reset if it kills an enemy Hero.",
        "icon": "storm_ui_icon_nova_tripletap.dds",
        "prerequisite": "NovaHeroicAbilityTripleTap"
      },
      {
        "id": "NovaMasteryPrecisionBarrage",
        "name": "Precision Barrage",
        "description": "Precision Strike now holds two charges with a short cooldown.",
        "icon": "storm_ui_icon_nova_orbitalstrike.dds",
        "prerequisite": "NovaHeroicAbilityPrecisionStrike"
      },
      {
        "id": "GenericTalentRewind",
        "name": "Rewind",
        "description": "Activate to reset the cooldowns of your Basic Abilities.",
        "icon": "storm_btn_d3_wizard_slowtime.dds",
        "cooldown": 60
      },
      {
        "id": "GenericTalentFlashoftheStorms",
        "name": "Bolt of the Storm",
        "description": "Activate to teleport to a nearby location.",
        "icon": "storm_temp_btn-ability-protoss-blink-color.dds",
        "cooldown": 40
      }
    ]
  }
}
        

Change Log(back to top)

Version Date Patch Version Changes
2.7.19 Jul 22, 2016 44737
  • http://us.battle.net/heroes/en/blog/20185029/
  • http://us.battle.net/heroes/en/blog/20176357/
  • http://us.battle.net/heroes/en/blog/20164442/
2.7.18 Jun 29, 2016 44124
  • http://us.battle.net/heroes/en/blog/20167050/
2.7.17 Jun 14, 2016 43571
  • http://us.battle.net/heroes/en/blog/20143449
2.7.16 May 25, 2016 43170
  • http://us.battle.net/heroes/en/blog/20131411
2.7.15 May 19, 2016 43051
  • http://us.battle.net/heroes/en/blog/20120032/
  • http://us.battle.net/heroes/en/blog/20118416/
2.7.14 May 7, 2016 42590
  • http://us.battle.net/heroes/en/blog/20102776/
  • http://us.battle.net/heroes/en/blog/20097945/
2.7.12 Apr 21, 2016 42406
2.7.11 Apr 19, 2016 42273
  • http://us.battle.net/heroes/en/blog/20099322
2.7.10 Apr 12, 2016 42178
  • http://us.battle.net/heroes/en/blog/20090404
2.7.9 Mar 29, 2016 41810
  • http://us.battle.net/heroes/en/blog/20063493
2.7.8 Mar 16, 2016 41504
  • http://us.battle.net/heroes/en/blog/20057110
2.7.7 Mar 9, 2016 41393
  • http://us.battle.net/heroes/en/blog/20058183
2.7.6 Mar 2, 2016 41150
  • Added Xul
  • http://us.battle.net/heroes/en/blog/20049139
2.7.5 Feb 19, 2016 40798
  • http://us.battle.net/heroes/en/blog/20038832/heroes-of-the-storm-balance-update-notes-february-17-2016-2-17-2016
2.7.4 Feb 12, 2016 40697
  • Updated Nova's Snipe Mastery talent
2.7.3 Feb 5, 2016 40431
  • Fixed the 'Felstalker' mount to have the correct 'franchise'.
2.7.2 Feb 4, 2016 40431
  • Fixed some mount info and added more mount info.
2.7.1 Feb 4, 2016 40431
  • Added documentation for mounts.json file.
  • Added some missing mounts.
2.7.0 Feb 2, 2016 40431
  • Added Li-Ming!
2.6.1 Feb 1, 2016 40322
  • Updated to latest patch version.
  • Fixed the missing hpPerLevel and hpRegenPerLevel stats. These are percentages now.
2.6.0 Dec 15, 2015 39595
  • Added Greymane!
2.5.0 Dec 15, 2015 39595
  • Added Lunara!
2.4.0 Nov 22, 2015 39153
  • Added Cho!
  • Added Gall!
2.3.2 Oct 27, 2015 38793
  • Updated to latest patch version.
  • Fixed the 'manaCostPerSecond' field for Arthas ability Frozen Tempest
  • Fixed the 'cooldown' field for Medic trait Caduceus Reactor.
2.3.1 Oct 7, 2015 38236
  • Fixed the 'shortcut' field for the Artanis ability Twin Blades.
2.3.0 Oct 6, 2015 38236
  • Added Lt. Morales!
  • Added Artanis!
2.2.2 Sep 14, 2015 37569
  • Fixed the 'description' field for the Toxic Gas talent.
2.2.1 Sep 14, 2015 37569
  • Fixed the 'cooldown' field for the talents Ice Block, Improved Ice Block and Feign Death.
2.2.0 Sep 8, 2015 37569
  • Added Rexxar!
2.1.5 Sep 3, 2015 37117
  • Fixed the 'description' field for the Kerrigan ability Assimilation... again.
2.1.4 Aug 27, 2015 37117
  • Fixed the 'description' field for the Kerrigan ability Assimilation.
2.1.3 Aug 24, 2015 37117
  • Added missing 'per level' information to 17 abilities and talents.
2.1.2 Aug 24, 2015 37117
  • Fixed the 'description' field for Rehgar's Ghost Wolf ability and labeled it correctly as a mount.
2.1.1 Aug 18, 2015 37117
  • Fixed the 'name' field for some talents for both Brightwing and Tassadar.
  • Fixed multiple cooldowns across many abilities and talents.
2.1.0 Aug 18, 2015 37117
  • Added Monk!
  • Updated to latest patch data.
2.0.9 Aug 17, 2015 36536
  • Fixed the 'description' field for the Diablo ability Black Soulstone.
2.0.8 Aug 17, 2015 36536
  • Added an 'attributeid' field for each hero.
2.0.7 Aug 9, 2015 36536
  • Fixed values for talents First Aid, Promote and Bound Minion.
2.0.6 Aug 1, 2015 36536
  • Added missing 'per level' information to talents: Envenom, Burning Rage, Fury of the Storm.
2.0.5 Jul 31, 2015 36536
  • Added missing 'per level' information to 21 abilities and talents.
2.0.4 Jul 12, 2015 36144
  • Added a missing trait for the Lost Vikings.
2.0.3 Jul 12, 2015 36144
  • Added two missing abilities for the Lost Vikings.
  • Added subunit TychusOdin to Tychus including abilities and stats.
  • Added a missing ability to Uther.
2.0.2 Jun 30, 2015 36144
  • Added hero special mount abilities.
  • Added 'cooldown' fields to several abilities.
  • Removed an extraneous negative sign from Rehgar's Stormcaller talent.
2.0.1 Jun 30, 2015 36144
  • Added 'icon' field to each hero.
2.0.0 Jun 30, 2015 36144
  • Added Butcher and Leoric!
  • Updated to latest patch data.
1.2.2 Jun 29, 2015 35702
  • Fixed several errors with numbers for certain talents.
1.2.1 Jun 26, 2015 35702
  • Fixed some incorrectly named abilities.
1.2.0 Jun 26, 2015 35702
  • Fixed multiple errors in abilities and talents that showed NaN instead of the proper value.
  • Added 'icon' field to each talent and ability.
1.1.2 Jun 25, 2015 35702
  • Added 'description' field to each hero.
1.1.1 Jun 22, 2015 35702
  • Joined Lost Vikings abilities into one entry for LostVikings and added the switch viking abilities.
1.1.0 Jun 22, 2015 35702
  • Added secondary unit abilities (Abathur, Lost Vikings).
  • Added a 'shortcut' field to abilities to see how they map in game.
1.0.0 Jun 21, 2015 35702
  • First release!

License and Copyright(back to top)

The JSON files contain data that is Copyright (c) Blizzard Entertainment - All Rights Reserved

This website is not affiliated with Blizzard Entertainment in any way.


Thanks(back to top)




To-Do List(back to top)


Source Code(back to top)

Source code used to generate the JSON is available here: https://github.com/nydus/heroesjson