Hero Talent Details Endpoint

This endpoint is used for gathering hero talent win rates and popularity statistics. The following attributes are returned.

"Talent Name": {
  "games_played": games_played,
  "wins": wins,
  "losses": losses,
  "win_rate": win_rate,
  "popularity": popularity
}

Example Usage

{warning} All API calls require an api_token as part of the query string and are prefixed by https://api.heroesprofile.com/api

URL Parameters (required)

mode: (json or csv)

timeframe_type:  major or minor

timeframe:  e.g, 2.47, 2.47.1.75792

game_type: Full game type.  e.g.  Storm League

group_by_map: True or False

URL Parameters (as needed)

hero: (Full name for a hero.  e.g.  Muradin)

URL Parameters Extended Definitions

-timeframe_type: Either major or minor. major is used to gather all minor (balance) patches for a given patch cycle.

-timeframe: If major is provided as the timeframe_type, then this value needs to be the first 4 characters of the patch. e.g. 2.44, 2.46, 2.47. If minor is provided as the timeframe_type, then an actual patch value is required. e.g. 2.47.1.75792

Example Return

{
  "Abathur": {
    "1": {
      "Pressurized Glands": {
        "games_played": 2447,
        "wins": 1276,
        "losses": 1171,
        "win_rate": 52.15,
        "popularity": 55.5
      },
      "Envenomed Nest": {
        "games_played": 399,
        "wins": 153,
        "losses": 246,
        "win_rate": 38.35,
        "popularity": 9.05
      },
      "Reinforced Carapace": {
        "games_played": 1056,
        "wins": 464,
        "losses": 592,
        "win_rate": 43.94,
        "popularity": 23.95
      },
      "Survival Instincts": {
        "games_played": 507,
        "wins": 225,
        "losses": 282,
        "win_rate": 44.38,
        "popularity": 11.5
      }
    },
    "4": {
      "Adrenal Overload": {
        "games_played": 2740,
        "wins": 1335,
        "losses": 1405,
        "win_rate": 48.72,
        "popularity": 62.19
      },
      "Needlespine": {
        "games_played": 1085,
        "wins": 541,
        "losses": 544,
        "win_rate": 49.86,
        "popularity": 24.63
      },
      "Prolific Dispersal": {
        "games_played": 581,
        "wins": 242,
        "losses": 339,
        "win_rate": 41.65,
        "popularity": 13.19
      }
    },
    "7": {
      "Vile Nest": {
        "games_played": 291,
        "wins": 126,
        "losses": 165,
        "win_rate": 43.3,
        "popularity": 6.61
      },
      "Networked Carapace": {
        "games_played": 2190,
        "wins": 1109,
        "losses": 1081,
        "win_rate": 50.64,
        "popularity": 49.76
      },
      "Calldown: MULE": {
        "games_played": 1920,
        "wins": 883,
        "losses": 1037,
        "win_rate": 45.99,
        "popularity": 43.63
      }
    },
    "10": {
      "Ultimate Evolution": {
        "games_played": 3263,
        "wins": 1570,
        "losses": 1693,
        "win_rate": 48.12,
        "popularity": 74.62
      },
      "Evolve Monstrosity": {
        "games_played": 1110,
        "wins": 546,
        "losses": 564,
        "win_rate": 49.19,
        "popularity": 25.38
      }
    },
    "13": {
      "Spatial Efficiency": {
        "games_played": 558,
        "wins": 286,
        "losses": 272,
        "win_rate": 51.25,
        "popularity": 13.13
      },
      "Soma Transference": {
        "games_played": 3062,
        "wins": 1540,
        "losses": 1522,
        "win_rate": 50.29,
        "popularity": 72.05
      },
      "Bombard Strain": {
        "games_played": 630,
        "wins": 281,
        "losses": 349,
        "win_rate": 44.6,
        "popularity": 14.82
      }
    },
    "16": {
      "Envenomed Spikes": {
        "games_played": 1017,
        "wins": 568,
        "losses": 449,
        "win_rate": 55.85,
        "popularity": 26.68
      },
      "Adrenaline Boost": {
        "games_played": 1984,
        "wins": 1071,
        "losses": 913,
        "win_rate": 53.98,
        "popularity": 52.05
      },
      "Volatile Mutation": {
        "games_played": 244,
        "wins": 130,
        "losses": 114,
        "win_rate": 53.28,
        "popularity": 6.4
      },
      "Locust Brood": {
        "games_played": 567,
        "wins": 281,
        "losses": 286,
        "win_rate": 49.56,
        "popularity": 14.87
      }
    },
    "20": {
      "Evolutionary Link": {
        "games_played": 232,
        "wins": 139,
        "losses": 93,
        "win_rate": 59.91,
        "popularity": 9.67
      },
      "Evolution Complete": {
        "games_played": 118,
        "wins": 71,
        "losses": 47,
        "win_rate": 60.17,
        "popularity": 4.92
      },
      "Hivemind": {
        "games_played": 1752,
        "wins": 1173,
        "losses": 579,
        "win_rate": 66.95,
        "popularity": 73.06
      },
      "Locust Nest": {
        "games_played": 296,
        "wins": 183,
        "losses": 113,
        "win_rate": 61.82,
        "popularity": 12.34
      }
    }
  }
}