Hero Talent Builds Endpoint


This endpoint is used for gathering the top five hero talent builds. The following attributes are returned.

{
  "win_rate": win_rate,
    "build_talents": [
      "Talent Level 1",
      "Talent Level 4",
      "Talent Level 7",
      "Talent Level 10",
      "Talent Level 13",
      "Talent Level 16",
      "Talent Level 20",
    ]
}

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/Talents/Builds?timeframe_type=major&timeframe=2.47&game_type=Storm League Default
GET /Heroes/Talents/Builds?timeframe_type=minor&timeframe=2.47.1.75792&game_type=Quick Match Default
GET /Heroes/Talents/Builds?timeframe_type=minor&timeframe=2.47.1.75792&game_type=Quick Match&hero=Abathur 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

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": [
    {
      "win_rate": 59.82,
      "build_talents": [
        "Pressurized Glands",
        "Adrenal Overload",
        "Networked Carapace",
        "Ultimate Evolution",
        "Soma Transference",
        "Adrenaline Boost",
        "Hivemind"
      ]
    },
    {
      "win_rate": 54.51,
      "build_talents": [
        "Pressurized Glands",
        "Needlespine",
        "Calldown: MULE",
        "Ultimate Evolution",
        "Soma Transference",
        "Adrenaline Boost",
        "Hivemind"
      ]
    },
    {
      "win_rate": 51.76,
      "build_talents": [
        "Pressurized Glands",
        "Adrenal Overload",
        "Calldown: MULE",
        "Ultimate Evolution",
        "Soma Transference",
        "Adrenaline Boost",
        "Hivemind"
      ]
    },
    {
      "win_rate": 51.1,
      "build_talents": [
        "Pressurized Glands",
        "Adrenal Overload",
        "Calldown: MULE",
        "Ultimate Evolution",
        "Soma Transference",
        "Envenomed Spikes",
        "Hivemind"
      ]
    },
    {
      "win_rate": 49.7,
      "build_talents": [
        "Reinforced Carapace",
        "Adrenal Overload",
        "Networked Carapace",
        "Ultimate Evolution",
        "Soma Transference",
        "Adrenaline Boost",
        "Hivemind"
      ]
    }
  ]
}