Hero Matchups Endpoint

This endpoint is used for gathering hero matchups. The following attributes are returned.

{
  "hero": {
    "matchup hero": {
      "ally": {
        "wins_with": "wins_with",
        "losses_with": "losses_with",
        "win_rate_as_ally": win_rate_as_ally
      },
      "enemy": {
        "wins_against": "wins_against",
        "losses_against": "losses_against",
        "win_rate_against": win_rate_against
      }
    }
  }
}

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

hero:  Full hero name

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 with group_by_map = false

{
  "Abathur": {
    "Alarak": {
      "ally": {
        "wins_with": "46",
        "losses_with": "67",
        "win_rate_as_ally": "40.71"
      },
      "enemy": {
        "wins_against": "119",
        "losses_against": "106",
        "win_rate_against": "52.89"
      }
    },
    "Alexstrasza": {
      "ally": {
        "wins_with": "57",
        "losses_with": "72",
        "win_rate_as_ally": "44.19"
      },
      "enemy": {
        "wins_against": "105",
        "losses_against": "85",
        "win_rate_against": "55.26"
      }
    },
    "Ana": {
      "ally": {
        "wins_with": "87",
        "losses_with": "122",
        "win_rate_as_ally": "41.63"
      },
      "enemy": {
        "wins_against": "149",
        "losses_against": "147",
        "win_rate_against": "50.34"
      }
    },
    "Anduin": {
      "ally": {
        "wins_with": "159",
        "losses_with": "231",
        "win_rate_as_ally": "40.77"
      },
      "enemy": {
        "wins_against": "201",
        "losses_against": "249",
        "win_rate_against": "44.67"
      }
    },
    "Anub'arak": {
      "ally": {
        "wins_with": "89",
        "losses_with": "117",
        "win_rate_as_ally": "43.20"
      },
      "enemy": {
        "wins_against": "145",
        "losses_against": "115",
        "win_rate_against": "55.77"
      }
    },
    "Artanis": {
      "ally": {
        "wins_with": "76",
        "losses_with": "108",
        "win_rate_as_ally": "41.30"
      },
      "enemy": {
        "wins_against": "160",
        "losses_against": "134",
        "win_rate_against": "54.42"
      }
    },
    "Arthas": {
      "ally": {
        "wins_with": "121",
        "losses_with": "167",
        "win_rate_as_ally": "42.01"
      },
      "enemy": {
        "wins_against": "181",
        "losses_against": "161",
        "win_rate_against": "52.92"
      }
    },
    "Auriel": {
      "ally": {
        "wins_with": "178",
        "losses_with": "168",
        "win_rate_as_ally": "51.45"
      },
      "enemy": {
        "wins_against": "263",
        "losses_against": "137",
        "win_rate_against": "65.75"
      }
    },
    "Azmodan": {
      "ally": {
        "wins_with": "47",
        "losses_with": "58",
        "win_rate_as_ally": "44.76"
      },
      "enemy": {
        "wins_against": "118",
        "losses_against": "82",
        "win_rate_against": "59.00"
      }
    },
    "Blaze": {
      "ally": {
        "wins_with": "41",
        "losses_with": "64",
        "win_rate_as_ally": "39.05"
      },
      "enemy": {
        "wins_against": "71",
        "losses_against": "67",
        "win_rate_against": "51.45"
      }
    },
    "Brightwing": {
      "ally": {
        "wins_with": "150",
        "losses_with": "215",
        "win_rate_as_ally": "41.10"
      },
      "enemy": {
        "wins_against": "265",
        "losses_against": "232",
        "win_rate_against": "53.32"
      }
    },
    "Cassia": {
      "ally": {
        "wins_with": "39",
        "losses_with": "41",
        "win_rate_as_ally": "48.75"
      },
      "enemy": {
        "wins_against": "80",
        "losses_against": "63",
        "win_rate_against": "55.94"
      }
    },
    "Chen": {
      "ally": {
        "wins_with": "35",
        "losses_with": "24",
        "win_rate_as_ally": "59.32"
      },
      "enemy": {
        "wins_against": "40",
        "losses_against": "35",
        "win_rate_against": "53.33"
      }
    },
    "Cho": {
      "ally": {
        "wins_with": "9",
        "losses_with": "14",
        "win_rate_as_ally": "39.13"
      },
      "enemy": {
        "wins_against": "13",
        "losses_against": "12",
        "win_rate_against": "52.00"
      }
    },
    "Chromie": {
      "ally": {
        "wins_with": "37",
        "losses_with": "76",
        "win_rate_as_ally": "32.74"
      },
      "enemy": {
        "wins_against": "87",
        "losses_against": "100",
        "win_rate_against": "46.52"
      }
    },
    "D.Va": {
      "ally": {
        "wins_with": "15",
        "losses_with": "24",
        "win_rate_as_ally": "38.46"
      },
      "enemy": {
        "wins_against": "34",
        "losses_against": "30",
        "win_rate_against": "53.13"
      }
    },
    "Deathwing": {
      "ally": {
        "wins_with": "73",
        "losses_with": "48",
        "win_rate_as_ally": "60.33"
      },
      "enemy": {
        "wins_against": "143",
        "losses_against": "81",
        "win_rate_against": "63.84"
      }
    },
    "Deckard": {
      "ally": {
        "wins_with": "48",
        "losses_with": "62",
        "win_rate_as_ally": "43.64"
      },
      "enemy": {
        "wins_against": "73",
        "losses_against": "59",
        "win_rate_against": "55.30"
      }
    },
  }
}