Hero Stats Endpoint


This endpoint is used for gathering hero win rate, ban rate, and popularity statistics. The following attributes are returned.

With group_by_map = false
"Hero": {
    "losses": losses,
    "wins": wins,
    "bans": bans,
    "games_played": games_played,
    "win_rate": win_rate,
    "popularity": popularity,
    "ban_rate": ban_rate,
    "pick_rate": pick_rate
  }
With group_by_map = true
{
  "Map": {
    "hero": {
      "losses": losses,
      "wins": wins,
      "bans": bans,
      "games_played": games_played,
      "win_rate": win_rate,
      "popularity": popularity,
      "ban_rate": ban_rate,
      "pick_rate": pick_rate
    }
  }
}

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

Method URI Headers
GET /Heroes/Stats?timeframe_type=major&timeframe=2.47&game_type=Storm League&group_by_map=false Default
GET /Heroes/Stats?timeframe_type=major&timeframe=2.47&game_type=Storm League&mode=csv&group_by_map=false Default
GET /Heroes/Stats?timeframe_type=minor&timeframe=2.47.1.75792&game_type=Quick Match&group_by_map=false Default

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 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

-group_by_map: This parameter group the data by maps. If set to true, it will show the data for each hero on each map.

Example Return with group_by_map = false

{
  "Abathur": {
    "losses": 1741,
    "wins": 1520,
    "bans": 7349,
    "games_played": 3261,
    "win_rate": 46.61,
    "popularity": 25.53,
    "ban_rate": 17.68,
    "pick_rate": 7.85
  },
  "Alarak": {
    "losses": 2379,
    "wins": 2514,
    "bans": 19488,
    "games_played": 4893,
    "win_rate": 51.38,
    "popularity": 58.67,
    "ban_rate": 46.9,
    "pick_rate": 11.77
  },
  "Alexstrasza": {
    "losses": 1735,
    "wins": 1590,
    "bans": 1130,
    "games_played": 3325,
    "win_rate": 47.82,
    "popularity": 10.72,
    "ban_rate": 2.72,
    "pick_rate": 8
  },
  "Ana": {
    "losses": 2527,
    "wins": 2353,
    "bans": 7335,
    "games_played": 4880,
    "win_rate": 48.22,
    "popularity": 29.39,
    "ban_rate": 17.65,
    "pick_rate": 11.74
  },
  "Anduin": {
    "losses": 5156,
    "wins": 4513,
    "bans": 5748,
    "games_played": 9669,
    "win_rate": 46.67,
    "popularity": 37.1,
    "ban_rate": 13.83,
    "pick_rate": 23.27
  },
  "Anub'arak": {
    "losses": 2715,
    "wins": 2540,
    "bans": 5585,
    "games_played": 5255,
    "win_rate": 48.33,
    "popularity": 26.09,
    "ban_rate": 13.44,
    "pick_rate": 12.65
  },
  "Artanis": {
    "losses": 2944,
    "wins": 2984,
    "bans": 1224,
    "games_played": 5928,
    "win_rate": 50.34,
    "popularity": 17.21,
    "ban_rate": 2.95,
    "pick_rate": 14.27
  },
  "Arthas": {
    "losses": 3161,
    "wins": 3045,
    "bans": 2346,
    "games_played": 6206,
    "win_rate": 49.07,
    "popularity": 20.58,
    "ban_rate": 5.65,
    "pick_rate": 14.93
  },
  "Auriel": {
    "losses": 2727,
    "wins": 2984,
    "bans": 1443,
    "games_played": 5711,
    "win_rate": 52.25,
    "popularity": 17.22,
    "ban_rate": 3.47,
    "pick_rate": 13.74
  },
  "Azmodan": {
    "losses": 2702,
    "wins": 2664,
    "bans": 7413,
    "games_played": 5366,
    "win_rate": 49.65,
    "popularity": 30.75,
    "ban_rate": 17.84,
    "pick_rate": 12.91
  },
  "Blaze": {
    "losses": 1611,
    "wins": 1484,
    "bans": 242,
    "games_played": 3095,
    "win_rate": 47.95,
    "popularity": 8.03,
    "ban_rate": 0.58,
    "pick_rate": 7.45
  },
  "Brightwing": {
    "losses": 3611,
    "wins": 3457,
    "bans": 2840,
    "games_played": 7068,
    "win_rate": 48.91,
    "popularity": 23.84,
    "ban_rate": 6.83,
    "pick_rate": 17.01
  },
  "Cassia": {
    "losses": 1184,
    "wins": 1099,
    "bans": 296,
    "games_played": 2283,
    "win_rate": 48.14,
    "popularity": 6.21,
    "ban_rate": 0.71,
    "pick_rate": 5.49
  },
  "Chen": {
    "losses": 1294,
    "wins": 1321,
    "bans": 3738,
    "games_played": 2615,
    "win_rate": 50.52,
    "popularity": 15.29,
    "ban_rate": 9,
    "pick_rate": 6.29
  },
  "Cho": {
    "losses": 224,
    "wins": 145,
    "bans": 355,
    "games_played": 369,
    "win_rate": 39.3,
    "popularity": 1.74,
    "ban_rate": 0.85,
    "pick_rate": 0.89
  },
  "Chromie": {
    "losses": 1912,
    "wins": 1889,
    "bans": 1077,
    "games_played": 3801,
    "win_rate": 49.7,
    "popularity": 11.74,
    "ban_rate": 2.59,
    "pick_rate": 9.15
  },
  "D.Va": {
    "losses": 831,
    "wins": 692,
    "bans": 112,
    "games_played": 1523,
    "win_rate": 45.44,
    "popularity": 3.93,
    "ban_rate": 0.27,
    "pick_rate": 3.66
  },
  "Deckard": {
    "losses": 1647,
    "wins": 1448,
    "bans": 354,
    "games_played": 3095,
    "win_rate": 46.79,
    "popularity": 8.3,
    "ban_rate": 0.85,
    "pick_rate": 7.45
  },
  "Dehaka": {
    "losses": 1921,
    "wins": 1717,
    "bans": 2749,
    "games_played": 3638,
    "win_rate": 47.2,
    "popularity": 15.37,
    "ban_rate": 6.62,
    "pick_rate": 8.75
  },
  "Diablo": {
    "losses": 5460,
    "wins": 4533,
    "bans": 14701,
    "games_played": 9993,
    "win_rate": 45.36,
    "popularity": 59.42,
    "ban_rate": 35.38,
    "pick_rate": 24.05
  },
  "E.T.C.": {
    "losses": 5593,
    "wins": 6445,
    "bans": 10709,
    "games_played": 12038,
    "win_rate": 53.54,
    "popularity": 54.74,
    "ban_rate": 25.77,
    "pick_rate": 28.97
  },
  "Falstad": {
    "losses": 3808,
    "wins": 4021,
    "bans": 3407,
    "games_played": 7829,
    "win_rate": 51.36,
    "popularity": 27.04,
    "ban_rate": 8.2,
    "pick_rate": 18.84
  },
  "Fenix": {
    "losses": 1840,
    "wins": 2054,
    "bans": 334,
    "games_played": 3894,
    "win_rate": 52.75,
    "popularity": 10.17,
    "ban_rate": 0.8,
    "pick_rate": 9.37
  },
  "Gall": {
    "losses": 224,
    "wins": 145,
    "bans": 200,
    "games_played": 369,
    "win_rate": 39.3,
    "popularity": 1.37,
    "ban_rate": 0.48,
    "pick_rate": 0.89
  },
  "Garrosh": {
    "losses": 3596,
    "wins": 3334,
    "bans": 14456,
    "games_played": 6930,
    "win_rate": 48.11,
    "popularity": 51.46,
    "ban_rate": 34.79,
    "pick_rate": 16.68
  },
  "Gazlowe": {
    "losses": 870,
    "wins": 1068,
    "bans": 251,
    "games_played": 1938,
    "win_rate": 55.11,
    "popularity": 5.27,
    "ban_rate": 0.6,
    "pick_rate": 4.66
  },
  "Genji": {
    "losses": 1554,
    "wins": 1094,
    "bans": 802,
    "games_played": 2648,
    "win_rate": 41.31,
    "popularity": 8.3,
    "ban_rate": 1.93,
    "pick_rate": 6.37
  },
  "Greymane": {
    "losses": 3003,
    "wins": 3108,
    "bans": 994,
    "games_played": 6111,
    "win_rate": 50.86,
    "popularity": 17.1,
    "ban_rate": 2.39,
    "pick_rate": 14.71
  },
  "Gul'dan": {
    "losses": 3800,
    "wins": 3417,
    "bans": 2772,
    "games_played": 7217,
    "win_rate": 47.35,
    "popularity": 24.04,
    "ban_rate": 6.67,
    "pick_rate": 17.37
  },
  "Hanzo": {
    "losses": 3683,
    "wins": 3104,
    "bans": 2098,
    "games_played": 6787,
    "win_rate": 45.73,
    "popularity": 21.38,
    "ban_rate": 5.05,
    "pick_rate": 16.33
  },
  "Illidan": {
    "losses": 1188,
    "wins": 1070,
    "bans": 858,
    "games_played": 2258,
    "win_rate": 47.39,
    "popularity": 7.5,
    "ban_rate": 2.06,
    "pick_rate": 5.43
  },
  "Imperius": {
    "losses": 2512,
    "wins": 2303,
    "bans": 605,
    "games_played": 4815,
    "win_rate": 47.83,
    "popularity": 13.04,
    "ban_rate": 1.46,
    "pick_rate": 11.59
  },
  "Jaina": {
    "losses": 5079,
    "wins": 5386,
    "bans": 3469,
    "games_played": 10465,
    "win_rate": 51.47,
    "popularity": 33.53,
    "ban_rate": 8.35,
    "pick_rate": 25.18
  },
  "Johanna": {
    "losses": 6917,
    "wins": 8055,
    "bans": 9331,
    "games_played": 14972,
    "win_rate": 53.8,
    "popularity": 58.48,
    "ban_rate": 22.45,
    "pick_rate": 36.03
  },
  "Junkrat": {
    "losses": 2899,
    "wins": 2797,
    "bans": 1173,
    "games_played": 5696,
    "win_rate": 49.1,
    "popularity": 16.53,
    "ban_rate": 2.82,
    "pick_rate": 13.71
  },
  "Kael'thas": {
    "losses": 4231,
    "wins": 4656,
    "bans": 23801,
    "games_played": 8887,
    "win_rate": 52.39,
    "popularity": 78.66,
    "ban_rate": 57.27,
    "pick_rate": 21.39
  },
  "Kel'Thuzad": {
    "losses": 2131,
    "wins": 2306,
    "bans": 4045,
    "games_played": 4437,
    "win_rate": 51.97,
    "popularity": 20.41,
    "ban_rate": 9.73,
    "pick_rate": 10.68
  },
  "Kerrigan": {
    "losses": 868,
    "wins": 1020,
    "bans": 285,
    "games_played": 1888,
    "win_rate": 54.03,
    "popularity": 5.23,
    "ban_rate": 0.69,
    "pick_rate": 4.54
  },
  "Kharazim": {
    "losses": 1150,
    "wins": 1160,
    "bans": 72,
    "games_played": 2310,
    "win_rate": 50.22,
    "popularity": 5.73,
    "ban_rate": 0.17,
    "pick_rate": 5.56
  },
  "Leoric": {
    "losses": 2186,
    "wins": 2342,
    "bans": 398,
    "games_played": 4528,
    "win_rate": 51.72,
    "popularity": 11.85,
    "ban_rate": 0.96,
    "pick_rate": 10.9
  },
  "Li Li": {
    "losses": 4138,
    "wins": 4084,
    "bans": 3844,
    "games_played": 8222,
    "win_rate": 49.67,
    "popularity": 29.04,
    "ban_rate": 9.25,
    "pick_rate": 19.79
  },
  "Li-Ming": {
    "losses": 4917,
    "wins": 4383,
    "bans": 2269,
    "games_played": 9300,
    "win_rate": 47.13,
    "popularity": 27.84,
    "ban_rate": 5.46,
    "pick_rate": 22.38
  },
  "Lt. Morales": {
    "losses": 2073,
    "wins": 1968,
    "bans": 1947,
    "games_played": 4041,
    "win_rate": 48.7,
    "popularity": 14.41,
    "ban_rate": 4.69,
    "pick_rate": 9.72
  },
  "LĂșcio": {
    "losses": 4007,
    "wins": 4373,
    "bans": 3364,
    "games_played": 8380,
    "win_rate": 52.18,
    "popularity": 28.26,
    "ban_rate": 8.1,
    "pick_rate": 20.17
  },
  "Lunara": {
    "losses": 2396,
    "wins": 2493,
    "bans": 527,
    "games_played": 4889,
    "win_rate": 50.99,
    "popularity": 13.03,
    "ban_rate": 1.27,
    "pick_rate": 11.76
  },
  "Maiev": {
    "losses": 1099,
    "wins": 1140,
    "bans": 1256,
    "games_played": 2239,
    "win_rate": 50.92,
    "popularity": 8.41,
    "ban_rate": 3.02,
    "pick_rate": 5.39
  },
  "Mal'Ganis": {
    "losses": 1928,
    "wins": 2306,
    "bans": 1014,
    "games_played": 4234,
    "win_rate": 54.46,
    "popularity": 12.63,
    "ban_rate": 2.44,
    "pick_rate": 10.19
  },
  "Malfurion": {
    "losses": 1822,
    "wins": 1794,
    "bans": 764,
    "games_played": 3616,
    "win_rate": 49.61,
    "popularity": 10.54,
    "ban_rate": 1.84,
    "pick_rate": 8.7
  },
  "Malthael": {
    "losses": 1838,
    "wins": 2091,
    "bans": 982,
    "games_played": 3929,
    "win_rate": 53.22,
    "popularity": 11.82,
    "ban_rate": 2.36,
    "pick_rate": 9.45
  },
  "Medivh": {
    "losses": 1016,
    "wins": 776,
    "bans": 491,
    "games_played": 1792,
    "win_rate": 43.3,
    "popularity": 5.49,
    "ban_rate": 1.18,
    "pick_rate": 4.31
  },
  "Mephisto": {
    "losses": 1073,
    "wins": 942,
    "bans": 162,
    "games_played": 2015,
    "win_rate": 46.75,
    "popularity": 5.24,
    "ban_rate": 0.39,
    "pick_rate": 4.85
  },
  "Muradin": {
    "losses": 5262,
    "wins": 4923,
    "bans": 1197,
    "games_played": 10185,
    "win_rate": 48.34,
    "popularity": 27.39,
    "ban_rate": 2.88,
    "pick_rate": 24.51
  },
  "Murky": {
    "losses": 929,
    "wins": 1015,
    "bans": 409,
    "games_played": 1944,
    "win_rate": 52.21,
    "popularity": 5.66,
    "ban_rate": 0.98,
    "pick_rate": 4.68
  },
  "Nazeebo": {
    "losses": 3215,
    "wins": 2919,
    "bans": 878,
    "games_played": 6134,
    "win_rate": 47.59,
    "popularity": 16.87,
    "ban_rate": 2.11,
    "pick_rate": 14.76
  },
  "Nova": {
    "losses": 975,
    "wins": 830,
    "bans": 218,
    "games_played": 1805,
    "win_rate": 45.98,
    "popularity": 4.87,
    "ban_rate": 0.52,
    "pick_rate": 4.34
  },
  "Orphea": {
    "losses": 2717,
    "wins": 2611,
    "bans": 767,
    "games_played": 5328,
    "win_rate": 49.01,
    "popularity": 14.67,
    "ban_rate": 1.85,
    "pick_rate": 12.82
  },
  "Probius": {
    "losses": 201,
    "wins": 219,
    "bans": 65,
    "games_played": 420,
    "win_rate": 52.14,
    "popularity": 1.17,
    "ban_rate": 0.16,
    "pick_rate": 1.01
  },
  "Qhira": {
    "losses": 3254,
    "wins": 2745,
    "bans": 21020,
    "games_played": 5999,
    "win_rate": 45.76,
    "popularity": 65.02,
    "ban_rate": 50.58,
    "pick_rate": 14.44
  },
  "Ragnaros": {
    "losses": 2277,
    "wins": 2471,
    "bans": 1987,
    "games_played": 4748,
    "win_rate": 52.04,
    "popularity": 16.21,
    "ban_rate": 4.78,
    "pick_rate": 11.43
  },
  "Raynor": {
    "losses": 4314,
    "wins": 4766,
    "bans": 1293,
    "games_played": 9080,
    "win_rate": 52.49,
    "popularity": 24.96,
    "ban_rate": 3.11,
    "pick_rate": 21.85
  },
  "Rehgar": {
    "losses": 3530,
    "wins": 4162,
    "bans": 980,
    "games_played": 7692,
    "win_rate": 54.11,
    "popularity": 20.87,
    "ban_rate": 2.36,
    "pick_rate": 18.51
  },
  "Rexxar": {
    "losses": 1416,
    "wins": 1983,
    "bans": 3361,
    "games_played": 3399,
    "win_rate": 58.34,
    "popularity": 16.27,
    "ban_rate": 8.09,
    "pick_rate": 8.18
  },
  "Samuro": {
    "losses": 523,
    "wins": 564,
    "bans": 463,
    "games_played": 1087,
    "win_rate": 51.89,
    "popularity": 3.73,
    "ban_rate": 1.11,
    "pick_rate": 2.62
  },
  "Sgt. Hammer": {
    "losses": 858,
    "wins": 831,
    "bans": 572,
    "games_played": 1689,
    "win_rate": 49.2,
    "popularity": 5.44,
    "ban_rate": 1.38,
    "pick_rate": 4.06
  },
  "Sonya": {
    "losses": 1983,
    "wins": 2003,
    "bans": 423,
    "games_played": 3986,
    "win_rate": 50.25,
    "popularity": 10.61,
    "ban_rate": 1.02,
    "pick_rate": 9.59
  },
  "Stitches": {
    "losses": 3815,
    "wins": 3342,
    "bans": 1057,
    "games_played": 7157,
    "win_rate": 46.7,
    "popularity": 19.77,
    "ban_rate": 2.54,
    "pick_rate": 17.22
  },
  "Stukov": {
    "losses": 2720,
    "wins": 2707,
    "bans": 2099,
    "games_played": 5427,
    "win_rate": 49.88,
    "popularity": 18.11,
    "ban_rate": 5.05,
    "pick_rate": 13.06
  },
  "Sylvanas": {
    "losses": 3825,
    "wins": 4010,
    "bans": 3015,
    "games_played": 7835,
    "win_rate": 51.18,
    "popularity": 26.11,
    "ban_rate": 7.26,
    "pick_rate": 18.85
  },
  "Tassadar": {
    "losses": 894,
    "wins": 864,
    "bans": 265,
    "games_played": 1758,
    "win_rate": 49.15,
    "popularity": 4.87,
    "ban_rate": 0.64,
    "pick_rate": 4.23
  },
  "The Butcher": {
    "losses": 1388,
    "wins": 1651,
    "bans": 1258,
    "games_played": 3039,
    "win_rate": 54.33,
    "popularity": 10.34,
    "ban_rate": 3.03,
    "pick_rate": 7.31
  },
  "The Lost Vikings": {
    "losses": 264,
    "wins": 258,
    "bans": 452,
    "games_played": 522,
    "win_rate": 49.43,
    "popularity": 2.34,
    "ban_rate": 1.09,
    "pick_rate": 1.26
  },
  "Thrall": {
    "losses": 4381,
    "wins": 4571,
    "bans": 784,
    "games_played": 8952,
    "win_rate": 51.06,
    "popularity": 23.43,
    "ban_rate": 1.89,
    "pick_rate": 21.54
  },
  "Tracer": {
    "losses": 891,
    "wins": 774,
    "bans": 371,
    "games_played": 1665,
    "win_rate": 46.49,
    "popularity": 4.9,
    "ban_rate": 0.89,
    "pick_rate": 4.01
  },
  "Tychus": {
    "losses": 1935,
    "wins": 1875,
    "bans": 561,
    "games_played": 3810,
    "win_rate": 49.21,
    "popularity": 10.52,
    "ban_rate": 1.35,
    "pick_rate": 9.17
  },
  "Tyrael": {
    "losses": 1276,
    "wins": 1216,
    "bans": 167,
    "games_played": 2492,
    "win_rate": 48.8,
    "popularity": 6.4,
    "ban_rate": 0.4,
    "pick_rate": 6
  },
  "Tyrande": {
    "losses": 1330,
    "wins": 1380,
    "bans": 315,
    "games_played": 2710,
    "win_rate": 50.92,
    "popularity": 7.28,
    "ban_rate": 0.76,
    "pick_rate": 6.52
  },
  "Uther": {
    "losses": 2077,
    "wins": 2723,
    "bans": 862,
    "games_played": 4800,
    "win_rate": 56.73,
    "popularity": 13.62,
    "ban_rate": 2.07,
    "pick_rate": 11.55
  },
  "Valeera": {
    "losses": 894,
    "wins": 833,
    "bans": 358,
    "games_played": 1727,
    "win_rate": 48.23,
    "popularity": 5.02,
    "ban_rate": 0.86,
    "pick_rate": 4.16
  },
  "Valla": {
    "losses": 4234,
    "wins": 4493,
    "bans": 1420,
    "games_played": 8727,
    "win_rate": 51.48,
    "popularity": 24.42,
    "ban_rate": 3.42,
    "pick_rate": 21
  },
  "Varian": {
    "losses": 4578,
    "wins": 4433,
    "bans": 6779,
    "games_played": 9011,
    "win_rate": 49.2,
    "popularity": 38,
    "ban_rate": 16.31,
    "pick_rate": 21.68
  },
  "Whitemane": {
    "losses": 1777,
    "wins": 1397,
    "bans": 428,
    "games_played": 3174,
    "win_rate": 44.01,
    "popularity": 8.67,
    "ban_rate": 1.03,
    "pick_rate": 7.64
  },
  "Xul": {
    "losses": 959,
    "wins": 1020,
    "bans": 185,
    "games_played": 1979,
    "win_rate": 51.54,
    "popularity": 5.21,
    "ban_rate": 0.45,
    "pick_rate": 4.76
  },
  "Yrel": {
    "losses": 794,
    "wins": 619,
    "bans": 92,
    "games_played": 1413,
    "win_rate": 43.81,
    "popularity": 3.62,
    "ban_rate": 0.22,
    "pick_rate": 3.4
  },
  "Zagara": {
    "losses": 1050,
    "wins": 1149,
    "bans": 394,
    "games_played": 2199,
    "win_rate": 52.25,
    "popularity": 6.24,
    "ban_rate": 0.95,
    "pick_rate": 5.29
  },
  "Zarya": {
    "losses": 1123,
    "wins": 1128,
    "bans": 290,
    "games_played": 2251,
    "win_rate": 50.11,
    "popularity": 6.11,
    "ban_rate": 0.7,
    "pick_rate": 5.42
  },
  "Zeratul": {
    "losses": 1478,
    "wins": 1510,
    "bans": 3663,
    "games_played": 2988,
    "win_rate": 50.54,
    "popularity": 16,
    "ban_rate": 8.81,
    "pick_rate": 7.19
  },
  "Zul'jin": {
    "losses": 3722,
    "wins": 4058,
    "bans": 2336,
    "games_played": 7780,
    "win_rate": 52.16,
    "popularity": 24.34,
    "ban_rate": 5.62,
    "pick_rate": 18.72
  }
}