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

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 (optional)

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

hero_level: Filter by hero level. Supports multiple comma-separated values. Valid values: 1, 5, 10, 15, 20, 25, 40, 60, 80, 100. Example: hero_level=10,15,20

league_tier: Filter by league tier (0-6). Supports multiple comma-separated values. 0=Wood, 1=Bronze, 2=Silver, 3=Gold, 4=Platinum, 5=Diamond, 6=Master. Example: league_tier=4,5,6

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

-hero_level: (Optional) Filter results by hero level. Supports multiple values separated by commas. This allows you to see build statistics for games where players were at particular hero levels. Valid values: 1, 5, 10, 15, 20, 25, 40, 60, 80, 100. Examples: hero_level=10 (single level) or hero_level=10,15,20 (multiple levels).

-league_tier: (Optional) Filter results by league tier/rank. Supports multiple values separated by commas. This allows you to see build statistics for specific player skill levels. Values: 0=Wood, 1=Bronze, 2=Silver, 3=Gold, 4=Platinum, 5=Diamond, 6=Master. Examples: league_tier=5 (Diamond only) or league_tier=4,5,6 (Platinum, Diamond, and Master).

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"
      ]
    }
  ]
}