Heroes Endpoint

This endpoint is used for gathering hero metadata. The following attributes are returned. Translations are not included in csv format.

{
  "hero": {
    "id": id,
    "name": "name",
    "short_name": "short_name",
    "alt_name": "alt_name",
    "role": "role",
    "new_role": "new_role",
    "type": "type",
    "release_date": "release_date",
    "rework_date": "rework_date",
    "attribute_id": "attribute_id",
    "translations": [
      "translations 1",
      "translations 2",
      "translations 3",
      "translations 4",
      "translations 5"
    ]
  }
}

Example Usage

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

Method URI Headers
GET /Heroes Default
GET /Heroes?hero=Abathur Default
GET /Heroes?role=Support Default

Extra Calls for Paid Subscription

Method URI Headers
GET /Heroes?mode=csv Default

URL Parameters (as needed)

mode: (json or csv).  Only available with paid subscription

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

role: (Blizzard roles.  e.g. Melee Assassin)

Example Return

{
  "Abathur": {
    "id": 1,
    "name": "Abathur",
    "short_name": "abathur",
    "alt_name": null,
    "role": "Specialist",
    "new_role": "Support",
    "type": "Melee",
    "release_date": "2014-03-13 00:00:00",
    "rework_date": null,
    "attribute_id": "Abat",
    "translations": [
      "abathur",
      "abatur",
      "абатур",
      "阿巴瑟",
      "아바투르"
    ]
  },
  "Alarak": {
    "id": 2,
    "name": "Alarak",
    "short_name": "alarak",
    "alt_name": null,
    "role": "Assassin",
    "new_role": "Melee Assassin",
    "type": "Melee",
    "release_date": "2016-09-13 00:00:00",
    "rework_date": "2017-05-16 00:00:00",
    "attribute_id": "Alar",
    "translations": [
      "alarak",
      "аларак",
      "亞拉瑞克",
      "阿拉纳克",
      "알라라크"
    ]
  },
  "Anub'arak": {
    "id": 3,
    "name": "Anub'arak",
    "short_name": "anubarak",
    "alt_name": "Anubarak",
    "role": "Warrior",
    "new_role": "Tank",
    "type": "Melee",
    "release_date": "2014-10-07 00:00:00",
    "rework_date": "2017-03-14 00:00:00",
    "attribute_id": "Anub",
    "translations": [
      "Anub’arak",
      "anub'arak",
      "anub’arak",
      "ануб'арак",
      "阿努巴拉克",
      "아눕아락"
    ]
  },
  "Artanis": {
    "id": 4,
    "name": "Artanis",
    "short_name": "artanis",
    "alt_name": null,
    "role": "Warrior",
    "new_role": "Bruiser",
    "type": "Melee",
    "release_date": "2015-10-20 00:00:00",
    "rework_date": "2016-12-14 00:00:00",
    "attribute_id": "Arts",
    "translations": [
      "artanis",
      "артанис",
      "亞坦尼斯",
      "阿塔尼斯",
      "아르타니스"
    ]
  },
  "Arthas": {
    "id": 5,
    "name": "Arthas",
    "short_name": "arthas",
    "alt_name": null,
    "role": "Warrior",
    "new_role": "Tank",
    "type": "Melee",
    "release_date": "2014-03-13 00:00:00",
    "rework_date": "2017-03-14 00:00:00",
    "attribute_id": "Arth",
    "translations": [
      "arthas",
      "артас",
      "阿尔萨斯",
      "阿薩斯",
      "아서스"
    ]
  },
  "Auriel": {
    "id": 6,
    "name": "Auriel",
    "short_name": "auriel",
    "alt_name": null,
    "role": "Support",
    "new_role": "Healer",
    "type": "Ranged",
    "release_date": "2016-08-09 00:00:00",
    "rework_date": null,
    "attribute_id": "Auri",
    "translations": [
      "auriel",
      "Ауриэль",
      "ауриэль",
      "奥莉尔",
      "奧莉爾",
      "아우리엘"
    ]
  },
  "Azmodan": {
    "id": 7,
    "name": "Azmodan",
    "short_name": "azmodan",
    "alt_name": null,
    "role": "Specialist",
    "new_role": "Ranged Assassin",
    "type": "Ranged",
    "release_date": "2014-10-07 00:00:00",
    "rework_date": null,
    "attribute_id": "Azmo",
    "translations": [
      "Asmodan",
      "asmodan",
      "azmadan",
      "azmodan",
      "azmodán",
      "азмодан",
      "阿兹莫丹",
      "阿茲莫丹",
      "아즈모단"
    ]
  }
}