In Development: Character Profile Mythic Keystone Dungeon API

API Discussion
Greetings all!

We wanted to take a moment and share with you some in-development feature additions we are working on for the character profile APIs exposed via the WoW Game Data APIs.

As some of you may have heard at BlizzCon, we are looking at adding information about Mythic Keystone Dungeon runs to the character profiles (a.k.a., Armory) on the WoW community website. We are also working on exposing this data to community consumers through the WoW Game Data APIs.

At a high level, we will be adding data that includes the seasonal best run for each dungeon. This data will include the seasonal best within qualifying time, as well as the seasonal best by Keystone level (in the event that the two runs are identical, only the seasonal best within qualifying time would be included in the data).

While this addition is still very much in-development, we wanted to give you all a sneak peek. We will also be looking to add some new dynamically and statically namespaced documents, to include Mythic Keystone Profile Season, Mythic Keystone Dungeon, and several others. See the list below for the documents we intend to release with this update.


  • /profile/wow/character/{realm}/{name}/mythic-keystone-profile
  • /profile/wow/character/{realm}/{name}/mythic-keystone-profile/season/{id}
  • /data/wow/mythic-keystone/season/
  • /data/wow/mythic-keystone/season/{id}
  • /data/wow/mythic-keystone/period/
  • /data/wow/mythic-keystone/period/{id}
  • /data/wow/mythic-keystone/dungeon/
  • /data/wow/mythic-keystone/dungeon/{id}
  • /data/wow/keystone-affix/
  • /data/wow/keystone-affix/{id}
  • /data/wow/media/keystone-affix/{id}
  • /data/wow/race/
  • /data/wow/race/<id>
  • /data/wow/playable-class/
  • /data/wow/playable-class/{id}
  • /data/wow/playable-class/{id}/pvp-talent-slots
  • /data/wow/power-type/
  • /data/wow/power-type/{id}
  • /data/wow/talent/
  • /data/wow/talent/{id}
  • /data/wow/pvp-talent/
  • /data/wow/pvp-talent/{id}
  • /data/wow/spell/{id}
  • /data/wow/media/spell/{id}


Please see the examples below for some of the newer document structures for Mythic Keystone Profile, Mythic Keystone Dungeon, and Mythic Keystone Season.

Mythic Keystone Profile

{
"_links": {
"self": {
"href": "https://us.api.blizzard.com/profile/wow/character/realm-name/character-name/mythic-keystone-profile"
}
},
"character": {
"href": "https://us.api.blizzard.com/profile/wow/character/realm-name/character-name"
},
"current_period": {
"period": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/period/670"
},
"id": 670
},
"best_runs": [
{
"completed_timestamp": 1541181900000,
"duration": 720000,
"keystone_level": 22,
"keystone_affixes": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/9"
},
"name": {
"en_US": "Tyrannical",
"es_MX": "Tiránico",
"pt_BR": "Tirânica",
"de_DE": "Tyrannisch",
"en_GB": "Tyrannical",
"es_ES": "Tiránica",
"fr_FR": "Tyrannique",
"it_IT": "Tirannia",
"ru_RU": "Тиранический",
"ko_KR": "폭군",
"zh_TW": "暴君",
"zh_CN": "残暴"
},
"id": 9
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/7"
},
"name": {
"en_US": "Bolstering",
"es_MX": "Reforzando",
"pt_BR": "Encorajadora",
"de_DE": "Anstachelnd",
"en_GB": "Bolstering",
"es_ES": "Potenciante",
"fr_FR": "Galvanisant",
"it_IT": "Rinforzo",
"ru_RU": "Усиливающий",
"ko_KR": "강화",
"zh_TW": "激勵",
"zh_CN": "激励"
},
"id": 7
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/3"
},
"name": {
"en_US": "Volcanic",
"es_MX": "Volcánico",
"pt_BR": "Vulcânica",
"de_DE": "Vulkanisch",
"en_GB": "Volcanic",
"es_ES": "Volcánica",
"fr_FR": "Volcanique",
"it_IT": "Eruzione",
"ru_RU": "Вулканический",
"ko_KR": "화산",
"zh_TW": "火山",
"zh_CN": "火山"
},
"id": 3
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/16"
},
"name": {
"en_US": "Infested",
"es_MX": "Infestado",
"pt_BR": "Infestado",
"de_DE": "Befallen",
"en_GB": "Infested",
"es_ES": "Infestada",
"fr_FR": "Infesté",
"it_IT": "Infestazione",
"ru_RU": "Зараженный",
"ko_KR": "감염",
"zh_TW": "感染",
"zh_CN": "共生"
},
"id": 16
}
],
"members": [
{
"character": {
"name": "character-name",
"id": 1,
"realm": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/realm/1"
},
"id": 1,
"slug": "realm-slug"
}
},
"specialization": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/playable-specialization/577"
},
"name": {
"en_US": "Havoc",
"es_MX": "Caos",
"pt_BR": "Devastação",
"de_DE": "Verwüstung",
"en_GB": "Havoc",
"es_ES": "Devastación",
"fr_FR": "Dévastation",
"it_IT": "Rovina",
"ru_RU": "Истребление",
"ko_KR": "파멸",
"zh_TW": "災虐",
"zh_CN": "浩劫"
},
"id": 577
},
"race": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/race/4"
},
"name": {
"en_US": "Night Elf",
"es_MX": "Elfo de la noche",
"pt_BR": "Elfo Noturno",
"de_DE": "Nachtelf",
"en_GB": "Night Elf",
"es_ES": "Elfo de la noche",
"fr_FR": "Elfe de la nuit",
"it_IT": "Elfo della Notte",
"ru_RU": "Ночной эльф",
"ko_KR": "나이트 엘프",
"zh_TW": "夜精靈",
"zh_CN": "暗夜精灵"
},
"id": 4
},
"equipped_item_level": 359
}
],
"dungeon": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/244"
},
"name": {
"en_US": "Atal'dazar",
"es_MX": "Atal'dazar",
"pt_BR": "Atal'Dazar",
"de_DE": "Atal'dazar",
"en_GB": "Atal'dazar",
"es_ES": "Atal'dazar",
"fr_FR": "Atal’Dazar",
"it_IT": "Atal'dazar",
"ru_RU": "Атал'Дазар",
"ko_KR": "아탈다자르",
"zh_TW": "阿塔達薩",
"zh_CN": "阿塔达萨"
},
"id": 244
}
},
{
"completed_timestamp": 1541176740000,
"duration": 323000,
"keystone_level": 8,
"keystone_affixes": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/10"
},
"name": {
"en_US": "Fortified",
"es_MX": "Reforzado",
"pt_BR": "Fortificada",
"de_DE": "Verstärkt",
"en_GB": "Fortified",
"es_ES": "Reforzada",
"fr_FR": "Fortifié",
"it_IT": "Potenziamento",
"ru_RU": "Укрепленный",
"ko_KR": "경화",
"zh_TW": "強悍",
"zh_CN": "强韧"
},
"id": 10
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/11"
},
"name": {
"en_US": "Bursting",
"es_MX": "Llameante",
"pt_BR": "Estilhaçante",
"de_DE": "Platzend",
"en_GB": "Bursting",
"es_ES": "Detonante",
"fr_FR": "Détonant",
"it_IT": "Esplosione",
"ru_RU": "Взрывной",
"ko_KR": "파열",
"zh_TW": "屍爆",
"zh_CN": "崩裂"
},
"id": 11
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/14"
},
"name": {
"en_US": "Quaking",
"es_MX": "Tembloroso",
"pt_BR": "Estremecedora",
"de_DE": "Bebend",
"en_GB": "Quaking",
"es_ES": "Sísmica",
"fr_FR": "Sismique",
"it_IT": "Sisma",
"ru_RU": "Сотрясающий",
"ko_KR": "전율",
"zh_TW": "震地",
"zh_CN": "震荡"
},
"id": 14
}
],
"members": [
{
"character": {
"name": "character-name",
"id": 1,
"realm": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/realm/1"
},
"id": 1,
"slug": "realm-slug"
}
},
"specialization": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/playable-specialization/577"
},
"name": {
"en_US": "Havoc",
"es_MX": "Caos",
"pt_BR": "Devastação",
"de_DE": "Verwüstung",
"en_GB": "Havoc",
"es_ES": "Devastación",
"fr_FR": "Dévastation",
"it_IT": "Rovina",
"ru_RU": "Истребление",
"ko_KR": "파멸",
"zh_TW": "災虐",
"zh_CN": "浩劫"
},
"id": 577
},
"race": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/race/4"
},
"name": {
"en_US": "Night Elf",
"es_MX": "Elfo de la noche",
"pt_BR": "Elfo Noturno",
"de_DE": "Nachtelf",
"en_GB": "Night Elf",
"es_ES": "Elfo de la noche",
"fr_FR": "Elfe de la nuit",
"it_IT": "Elfo della Notte",
"ru_RU": "Ночной эльф",
"ko_KR": "나이트 엘프",
"zh_TW": "夜精靈",
"zh_CN": "暗夜精灵"
},
"id": 4
},
"equipped_item_level": 356
}
],
"dungeon": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/247"
},
"name": {
"en_US": "The MOTHERLODE!!",
"es_MX": "¡¡El FILÓN!!",
"pt_BR": "A MEGAMINA!!!",
"de_DE": "Das RIESENFLÖZ!!",
"en_GB": "The MOTHERLODE!!",
"es_ES": "VETA MADRE",
"fr_FR": "Le Filon",
"it_IT": "Vena Madre",
"ru_RU": "ЗОЛОТАЯ ЖИЛА!!!",
"ko_KR": "왕노다지 광산!!",
"zh_TW": "晶喜鎮!",
"zh_CN": "暴富矿区!!"
},
"id": 247
}
},
{
"completed_timestamp": 1541178780000,
"duration": 1018000,
"keystone_level": 11,
"keystone_affixes": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/10"
},
"name": {
"en_US": "Fortified",
"es_MX": "Reforzado",
"pt_BR": "Fortificada",
"de_DE": "Verstärkt",
"en_GB": "Fortified",
"es_ES": "Reforzada",
"fr_FR": "Fortifié",
"it_IT": "Potenziamento",
"ru_RU": "Укрепленный",
"ko_KR": "경화",
"zh_TW": "強悍",
"zh_CN": "强韧"
},
"id": 10
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/11"
},
"name": {
"en_US": "Bursting",
"es_MX": "Llameante",
"pt_BR": "Estilhaçante",
"de_DE": "Platzend",
"en_GB": "Bursting",
"es_ES": "Detonante",
"fr_FR": "Détonant",
"it_IT": "Esplosione",
"ru_RU": "Взрывной",
"ko_KR": "파열",
"zh_TW": "屍爆",
"zh_CN": "崩裂"
},
"id": 11
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/14"
},
"name": {
"en_US": "Quaking",
"es_MX": "Tembloroso",
"pt_BR": "Estremecedora",
"de_DE": "Bebend",
"en_GB": "Quaking",
"es_ES": "Sísmica",
"fr_FR": "Sismique",
"it_IT": "Sisma",
"ru_RU": "Сотрясающий",
"ko_KR": "전율",
"zh_TW": "震地",
"zh_CN": "震荡"
},
"id": 14
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/16"
},
"name": {
"en_US": "Infested",
"es_MX": "Infestado",
"pt_BR": "Infestado",
"de_DE": "Befallen",
"en_GB": "Infested",
"es_ES": "Infestada",
"fr_FR": "Infesté",
"it_IT": "Infestazione",
"ru_RU": "Зараженный",
"ko_KR": "감염",
"zh_TW": "感染",
"zh_CN": "共生"
},
"id": 16
}
],
"members": [
{
"character": {
"name": "character-name",
"id": 1,
"realm": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/realm/1"
},
"id": 1,
"slug": "realm-slug"
}
},
"specialization": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/playable-specialization/577"
},
"name": {
"en_US": "Havoc",
"es_MX": "Caos",
"pt_BR": "Devastação",
"de_DE": "Verwüstung",
"en_GB": "Havoc",
"es_ES": "Devastación",
"fr_FR": "Dévastation",
"it_IT": "Rovina",
"ru_RU": "Истребление",
"ko_KR": "파멸",
"zh_TW": "災虐",
"zh_CN": "浩劫"
},
"id": 577
},
"race": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/race/4"
},
"name": {
"en_US": "Night Elf",
"es_MX": "Elfo de la noche",
"pt_BR": "Elfo Noturno",
"de_DE": "Nachtelf",
"en_GB": "Night Elf",
"es_ES": "Elfo de la noche",
"fr_FR": "Elfe de la nuit",
"it_IT": "Elfo della Notte",
"ru_RU": "Ночной эльф",
"ko_KR": "나이트 엘프",
"zh_TW": "夜精靈",
"zh_CN": "暗夜精灵"
},
"id": 4
},
"equipped_item_level": 357
}
],
"dungeon": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/250"
},
"name": {
"en_US": "Temple of Sethraliss",
"es_MX": "Templo de Sethraliss",
"pt_BR": "Templo de Sethraliss",
"de_DE": "Der Tempel von Sethraliss",
"en_GB": "Temple of Sethraliss",
"es_ES": "Templo de Sethraliss",
"fr_FR": "Temple de Sephraliss",
"it_IT": "Tempio di Sethraliss",
"ru_RU": "Храм Сетралисс",
"ko_KR": "세스랄리스 사원",
"zh_TW": "瑟沙利斯神廟",
"zh_CN": "塞塔里斯神庙"
},
"id": 250
}
},
{
"completed_timestamp": 1541176200000,
"duration": 259000,
"keystone_level": 5,
"keystone_affixes": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/10"
},
"name": {
"en_US": "Fortified",
"es_MX": "Reforzado",
"pt_BR": "Fortificada",
"de_DE": "Verstärkt",
"en_GB": "Fortified",
"es_ES": "Reforzada",
"fr_FR": "Fortifié",
"it_IT": "Potenziamento",
"ru_RU": "Укрепленный",
"ko_KR": "경화",
"zh_TW": "強悍",
"zh_CN": "强韧"
},
"id": 10
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/11"
},
"name": {
"en_US": "Bursting",
"es_MX": "Llameante",
"pt_BR": "Estilhaçante",
"de_DE": "Platzend",
"en_GB": "Bursting",
"es_ES": "Detonante",
"fr_FR": "Détonant",
"it_IT": "Esplosione",
"ru_RU": "Взрывной",
"ko_KR": "파열",
"zh_TW": "屍爆",
"zh_CN": "崩裂"
},
"id": 11
}
],
"members": [
{
"character": {
"name": "character-name",
"id": 1,
"realm": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/realm/1"
},
"id": 1,
"slug": "realm-slug"
}
},
"specialization": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/playable-specialization/577"
},
"name": {
"en_US": "Havoc",
"es_MX": "Caos",
"pt_BR": "Devastação",
"de_DE": "Verwüstung",
"en_GB": "Havoc",
"es_ES": "Devastación",
"fr_FR": "Dévastation",
"it_IT": "Rovina",
"ru_RU": "Истребление",
"ko_KR": "파멸",
"zh_TW": "災虐",
"zh_CN": "浩劫"
},
"id": 577
},
"race": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/race/4"
},
"name": {
"en_US": "Night Elf",
"es_MX": "Elfo de la noche",
"pt_BR": "Elfo Noturno",
"de_DE": "Nachtelf",
"en_GB": "Night Elf",
"es_ES": "Elfo de la noche",
"fr_FR": "Elfe de la nuit",
"it_IT": "Elfo della Notte",
"ru_RU": "Ночной эльф",
"ko_KR": "나이트 엘프",
"zh_TW": "夜精靈",
"zh_CN": "暗夜精灵"
},
"id": 4
},
"equipped_item_level": 356
}
],
"dungeon": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/248"
},
"name": {
"en_US": "Waycrest Manor",
"es_MX": "Mansión Tarjasenda",
"pt_BR": "Mansão Capelo",
"de_DE": "Das Kronsteiganwesen",
"en_GB": "Waycrest Manor",
"es_ES": "Mansión Crestavía",
"fr_FR": "Manoir Malvoie",
"it_IT": "Maniero dei Crestabianca",
"ru_RU": "Усадьба Уэйкрестов",
"ko_KR": "웨이크레스트 저택",
"zh_TW": "威奎斯特莊園",
"zh_CN": "维克雷斯庄园"
},
"id": 248
}
}
]
},
"seasons": [
{
"key": {
"href": "https://us.api.blizzard.com/profile/wow/character/realm-name/character-name/mythic-keystone-profile/season/4"
},
"id": 4
}
]
}


Mythic Keystone Profile Season

{
"_links": {
"self": {
"href": "https://us.api.blizzard.com/profile/wow/character/realm-slug/character-name/mythic-keystone-profile/season/4"
}
},
"season": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/season/4"
},
"id": 4
},
"best_runs": [
{
"completed_timestamp": 1541178780000,
"duration": 1018000,
"keystone_level": 11,
"keystone_affixes": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/10"
},
"name": {
"en_US": "Fortified",
"es_MX": "Reforzado",
"pt_BR": "Fortificada",
"de_DE": "Verstärkt",
"en_GB": "Fortified",
"es_ES": "Reforzada",
"fr_FR": "Fortifié",
"it_IT": "Potenziamento",
"ru_RU": "Укрепленный",
"ko_KR": "경화",
"zh_TW": "強悍",
"zh_CN": "强韧"
},
"id": 10
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/11"
},
"name": {
"en_US": "Bursting",
"es_MX": "Llameante",
"pt_BR": "Estilhaçante",
"de_DE": "Platzend",
"en_GB": "Bursting",
"es_ES": "Detonante",
"fr_FR": "Détonant",
"it_IT": "Esplosione",
"ru_RU": "Взрывной",
"ko_KR": "파열",
"zh_TW": "屍爆",
"zh_CN": "崩裂"
},
"id": 11
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/14"
},
"name": {
"en_US": "Quaking",
"es_MX": "Tembloroso",
"pt_BR": "Estremecedora",
"de_DE": "Bebend",
"en_GB": "Quaking",
"es_ES": "Sísmica",
"fr_FR": "Sismique",
"it_IT": "Sisma",
"ru_RU": "Сотрясающий",
"ko_KR": "전율",
"zh_TW": "震地",
"zh_CN": "震荡"
},
"id": 14
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/16"
},
"name": {
"en_US": "Infested",
"es_MX": "Infestado",
"pt_BR": "Infestado",
"de_DE": "Befallen",
"en_GB": "Infested",
"es_ES": "Infestada",
"fr_FR": "Infesté",
"it_IT": "Infestazione",
"ru_RU": "Зараженный",
"ko_KR": "감염",
"zh_TW": "感染",
"zh_CN": "共生"
},
"id": 16
}
],
"members": [
{
"character": {
"name": "character-name",
"id": 16001,
"realm": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/realm/3183"
},
"id": 3183,
"slug": "realm-slug"
}
},
"specialization": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/playable-specialization/577"
},
"name": {
"en_US": "Havoc",
"es_MX": "Caos",
"pt_BR": "Devastação",
"de_DE": "Verwüstung",
"en_GB": "Havoc",
"es_ES": "Devastación",
"fr_FR": "Dévastation",
"it_IT": "Rovina",
"ru_RU": "Истребление",
"ko_KR": "파멸",
"zh_TW": "災虐",
"zh_CN": "浩劫"
},
"id": 577
},
"race": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/race/4"
},
"name": {
"en_US": "Night Elf",
"es_MX": "Elfo de la noche",
"pt_BR": "Elfo Noturno",
"de_DE": "Nachtelf",
"en_GB": "Night Elf",
"es_ES": "Elfo de la noche",
"fr_FR": "Elfe de la nuit",
"it_IT": "Elfo della Notte",
"ru_RU": "Ночной эльф",
"ko_KR": "나이트 엘프",
"zh_TW": "夜精靈",
"zh_CN": "暗夜精灵"
},
"id": 4
},
"equipped_item_level": 357
}
],
"dungeon": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/250"
},
"name": {
"en_US": "Temple of Sethraliss",
"es_MX": "Templo de Sethraliss",
"pt_BR": "Templo de Sethraliss",
"de_DE": "Der Tempel von Sethraliss",
"en_GB": "Temple of Sethraliss",
"es_ES": "Templo de Sethraliss",
"fr_FR": "Temple de Sephraliss",
"it_IT": "Tempio di Sethraliss",
"ru_RU": "Храм Сетралисс",
"ko_KR": "세스랄리스 사원",
"zh_TW": "瑟沙利斯神廟",
"zh_CN": "塞塔里斯神庙"
},
"id": 250
}
},
{
"completed_timestamp": 1541176740000,
"duration": 323000,
"keystone_level": 8,
"keystone_affixes": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/10"
},
"name": {
"en_US": "Fortified",
"es_MX": "Reforzado",
"pt_BR": "Fortificada",
"de_DE": "Verstärkt",
"en_GB": "Fortified",
"es_ES": "Reforzada",
"fr_FR": "Fortifié",
"it_IT": "Potenziamento",
"ru_RU": "Укрепленный",
"ko_KR": "경화",
"zh_TW": "強悍",
"zh_CN": "强韧"
},
"id": 10
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/11"
},
"name": {
"en_US": "Bursting",
"es_MX": "Llameante",
"pt_BR": "Estilhaçante",
"de_DE": "Platzend",
"en_GB": "Bursting",
"es_ES": "Detonante",
"fr_FR": "Détonant",
"it_IT": "Esplosione",
"ru_RU": "Взрывной",
"ko_KR": "파열",
"zh_TW": "屍爆",
"zh_CN": "崩裂"
},
"id": 11
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/14"
},
"name": {
"en_US": "Quaking",
"es_MX": "Tembloroso",
"pt_BR": "Estremecedora",
"de_DE": "Bebend",
"en_GB": "Quaking",
"es_ES": "Sísmica",
"fr_FR": "Sismique",
"it_IT": "Sisma",
"ru_RU": "Сотрясающий",
"ko_KR": "전율",
"zh_TW": "震地",
"zh_CN": "震荡"
},
"id": 14
}
],
"members": [
{
"character": {
"name": "character-name",
"id": 16001,
"realm": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/realm/3183"
},
"id": 3183,
"slug": "realm-slug"
}
},
"specialization": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/playable-specialization/577"
},
"name": {
"en_US": "Havoc",
"es_MX": "Caos",
"pt_BR": "Devastação",
"de_DE": "Verwüstung",
"en_GB": "Havoc",
"es_ES": "Devastación",
"fr_FR": "Dévastation",
"it_IT": "Rovina",
"ru_RU": "Истребление",
"ko_KR": "파멸",
"zh_TW": "災虐",
"zh_CN": "浩劫"
},
"id": 577
},
"race": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/race/4"
},
"name": {
"en_US": "Night Elf",
"es_MX": "Elfo de la noche",
"pt_BR": "Elfo Noturno",
"de_DE": "Nachtelf",
"en_GB": "Night Elf",
"es_ES": "Elfo de la noche",
"fr_FR": "Elfe de la nuit",
"it_IT": "Elfo della Notte",
"ru_RU": "Ночной эльф",
"ko_KR": "나이트 엘프",
"zh_TW": "夜精靈",
"zh_CN": "暗夜精灵"
},
"id": 4
},
"equipped_item_level": 356
}
],
"dungeon": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/247"
},
"name": {
"en_US": "The MOTHERLODE!!",
"es_MX": "¡¡El FILÓN!!",
"pt_BR": "A MEGAMINA!!!",
"de_DE": "Das RIESENFLÖZ!!",
"en_GB": "The MOTHERLODE!!",
"es_ES": "VETA MADRE",
"fr_FR": "Le Filon",
"it_IT": "Vena Madre",
"ru_RU": "ЗОЛОТАЯ ЖИЛА!!!",
"ko_KR": "왕노다지 광산!!",
"zh_TW": "晶喜鎮!",
"zh_CN": "暴富矿区!!"
},
"id": 247
}
},
{
"completed_timestamp": 1541181900000,
"duration": 720000,
"keystone_level": 22,
"keystone_affixes": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/9"
},
"name": {
"en_US": "Tyrannical",
"es_MX": "Tiránico",
"pt_BR": "Tirânica",
"de_DE": "Tyrannisch",
"en_GB": "Tyrannical",
"es_ES": "Tiránica",
"fr_FR": "Tyrannique",
"it_IT": "Tirannia",
"ru_RU": "Тиранический",
"ko_KR": "폭군",
"zh_TW": "暴君",
"zh_CN": "残暴"
},
"id": 9
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/7"
},
"name": {
"en_US": "Bolstering",
"es_MX": "Reforzando",
"pt_BR": "Encorajadora",
"de_DE": "Anstachelnd",
"en_GB": "Bolstering",
"es_ES": "Potenciante",
"fr_FR": "Galvanisant",
"it_IT": "Rinforzo",
"ru_RU": "Усиливающий",
"ko_KR": "강화",
"zh_TW": "激勵",
"zh_CN": "激励"
},
"id": 7
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/3"
},
"name": {
"en_US": "Volcanic",
"es_MX": "Volcánico",
"pt_BR": "Vulcânica",
"de_DE": "Vulkanisch",
"en_GB": "Volcanic",
"es_ES": "Volcánica",
"fr_FR": "Volcanique",
"it_IT": "Eruzione",
"ru_RU": "Вулканический",
"ko_KR": "화산",
"zh_TW": "火山",
"zh_CN": "火山"
},
"id": 3
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/16"
},
"name": {
"en_US": "Infested",
"es_MX": "Infestado",
"pt_BR": "Infestado",
"de_DE": "Befallen",
"en_GB": "Infested",
"es_ES": "Infestada",
"fr_FR": "Infesté",
"it_IT": "Infestazione",
"ru_RU": "Зараженный",
"ko_KR": "감염",
"zh_TW": "感染",
"zh_CN": "共生"
},
"id": 16
}
],
"members": [
{
"character": {
"name": "character-name",
"id": 16001,
"realm": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/realm/3183"
},
"id": 3183,
"slug": "realm-slug"
}
},
"specialization": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/playable-specialization/577"
},
"name": {
"en_US": "Havoc",
"es_MX": "Caos",
"pt_BR": "Devastação",
"de_DE": "Verwüstung",
"en_GB": "Havoc",
"es_ES": "Devastación",
"fr_FR": "Dévastation",
"it_IT": "Rovina",
"ru_RU": "Истребление",
"ko_KR": "파멸",
"zh_TW": "災虐",
"zh_CN": "浩劫"
},
"id": 577
},
"race": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/race/4"
},
"name": {
"en_US": "Night Elf",
"es_MX": "Elfo de la noche",
"pt_BR": "Elfo Noturno",
"de_DE": "Nachtelf",
"en_GB": "Night Elf",
"es_ES": "Elfo de la noche",
"fr_FR": "Elfe de la nuit",
"it_IT": "Elfo della Notte",
"ru_RU": "Ночной эльф",
"ko_KR": "나이트 엘프",
"zh_TW": "夜精靈",
"zh_CN": "暗夜精灵"
},
"id": 4
},
"equipped_item_level": 359
}
],
"dungeon": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/244"
},
"name": {
"en_US": "Atal'dazar",
"es_MX": "Atal'dazar",
"pt_BR": "Atal'Dazar",
"de_DE": "Atal'dazar",
"en_GB": "Atal'dazar",
"es_ES": "Atal'dazar",
"fr_FR": "Atal’Dazar",
"it_IT": "Atal'dazar",
"ru_RU": "Атал'Дазар",
"ko_KR": "아탈다자르",
"zh_TW": "阿塔達薩",
"zh_CN": "阿塔达萨"
},
"id": 244
}
},
{
"completed_timestamp": 1541176200000,
"duration": 259000,
"keystone_level": 5,
"keystone_affixes": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/10"
},
"name": {
"en_US": "Fortified",
"es_MX": "Reforzado",
"pt_BR": "Fortificada",
"de_DE": "Verstärkt",
"en_GB": "Fortified",
"es_ES": "Reforzada",
"fr_FR": "Fortifié",
"it_IT": "Potenziamento",
"ru_RU": "Укрепленный",
"ko_KR": "경화",
"zh_TW": "強悍",
"zh_CN": "强韧"
},
"id": 10
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/keystone-affix/11"
},
"name": {
"en_US": "Bursting",
"es_MX": "Llameante",
"pt_BR": "Estilhaçante",
"de_DE": "Platzend",
"en_GB": "Bursting",
"es_ES": "Detonante",
"fr_FR": "Détonant",
"it_IT": "Esplosione",
"ru_RU": "Взрывной",
"ko_KR": "파열",
"zh_TW": "屍爆",
"zh_CN": "崩裂"
},
"id": 11
}
],
"members": [
{
"character": {
"name": "character-name",
"id": 16001,
"realm": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/realm/3183"
},
"id": 3183,
"slug": "realm-slug"
}
},
"specialization": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/playable-specialization/577"
},
"name": {
"en_US": "Havoc",
"es_MX": "Caos",
"pt_BR": "Devastação",
"de_DE": "Verwüstung",
"en_GB": "Havoc",
"es_ES": "Devastación",
"fr_FR": "Dévastation",
"it_IT": "Rovina",
"ru_RU": "Истребление",
"ko_KR": "파멸",
"zh_TW": "災虐",
"zh_CN": "浩劫"
},
"id": 577
},
"race": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/race/4"
},
"name": {
"en_US": "Night Elf",
"es_MX": "Elfo de la noche",
"pt_BR": "Elfo Noturno",
"de_DE": "Nachtelf",
"en_GB": "Night Elf",
"es_ES": "Elfo de la noche",
"fr_FR": "Elfe de la nuit",
"it_IT": "Elfo della Notte",
"ru_RU": "Ночной эльф",
"ko_KR": "나이트 엘프",
"zh_TW": "夜精靈",
"zh_CN": "暗夜精灵"
},
"id": 4
},
"equipped_item_level": 356
}
],
"dungeon": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/248"
},
"name": {
"en_US": "Waycrest Manor",
"es_MX": "Mansión Tarjasenda",
"pt_BR": "Mansão Capelo",
"de_DE": "Das Kronsteiganwesen",
"en_GB": "Waycrest Manor",
"es_ES": "Mansión Crestavía",
"fr_FR": "Manoir Malvoie",
"it_IT": "Maniero dei Crestabianca",
"ru_RU": "Усадьба Уэйкрестов",
"ko_KR": "웨이크레스트 저택",
"zh_TW": "威奎斯特莊園",
"zh_CN": "维克雷斯庄园"
},
"id": 248
}
}
],
"character": {
"href": "https://us.api.blizzard.com/profile/wow/character/realm-slug/character-name"
}
}


Mythic Keystone Dungeon

{
"_links": {
"self": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/250"
}
},
"id": 250,
"name": {
"en_US": "Temple of Sethraliss",
"es_MX": "Templo de Sethraliss",
"pt_BR": "Templo de Sethraliss",
"de_DE": "Der Tempel von Sethraliss",
"en_GB": "Temple of Sethraliss",
"es_ES": "Templo de Sethraliss",
"fr_FR": "Temple de Sephraliss",
"it_IT": "Tempio di Sethraliss",
"ru_RU": "Храм Сетралисс",
"ko_KR": "세스랄리스 사원",
"zh_TW": "瑟沙利斯神廟",
"zh_CN": "塞塔里斯神庙"
},
"map": {
"name": {
"en_US": "Temple of Sethraliss",
"es_MX": "Templo de Sethraliss",
"pt_BR": "Templo de Sethraliss",
"de_DE": "Tempel von Sethraliss",
"en_GB": "Temple of Sethraliss",
"es_ES": "Templo de Sethraliss",
"fr_FR": "Temple de Sephraliss",
"it_IT": "Tempio di Sethraliss",
"ru_RU": "Храм Сетралисс",
"ko_KR": "세스랄리스 사원",
"zh_TW": "瑟沙利斯神廟",
"zh_CN": "塞塔里斯神庙"
},
"id": 1877
},
"zone": {
"slug": "temple-of-sethraliss"
},
"keystone_upgrades": [
{
"upgrade_level": 1,
"qualifying_duration": 2160
},
{
"upgrade_level": 2,
"qualifying_duration": 1728
},
{
"upgrade_level": 3,
"qualifying_duration": 1296
}
]
}


We’re thrilled about these new features and hope you enjoyed this early preview. Stay tuned for more updates!

Cheers!
These look great, Maguthul! It's a wonderful change, and I am thankful for the continued support and commitment from Blizzard and the API devs to provide such a wealth of data to community developers.

The API you described will make a HUGE improvement just as is. However, while reviewing it there were a few things I wondered about, so I wanted to relay those thoughts/questions:

1) Do you know if "race" in the members document will be static after it is created, or will it change to reflect the user's race if they were to faction/race change? (like how "faction" in the keystone leaderboards document will change during a period).

2) Would it be possible to have the keystone leaderboards API also include these equipped_item_level / race fields for members of a group, just for consistency reasons? (Maybe it already does now and I just missed this?)

3) If we have equipped_item_level in the document, would it be feasible to extend this to also include the actual gear they were snapshotted with? (I can imagine this might be a good bit of data bloat)
I'm more of an auction/quest guy than a mythic keystone guy, but I know these additions will make a lot of developers and players happy. Kudos. :)
Will the `current_period` object contain all of the data surrounding the current active season?
@Maguthul Awesome news. Thanks for the sneak peak. Look forward to the updates. Tell the developer teams thanks for all the hard work!

There is definitely some cool stuff I see in the endpoint list.
Hey Jimo,

11/13/2018 07:54 PMPosted by Jimo
Will the `current_period` object contain all of the data surrounding the current active season?


The Mythic Keystone Period (linked to via 'current_period') will include the following data:

{
"_links": {
"self": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/period/1"
}
},
"id": 1,
"start_timestamp": 123456700000,
"end_timestamp": 123456780000
}


The best way to derive the current season<Mythic Keystone Profile Season> from the Mythic Keystone Profile document will be by retrieving the latest entry in the seasons array, resolving the Mythic Keystone Profile Season, and then resolving its Mythic Keystone Season link. This is a bit round-about though, so it will likely be better to use the method below by first consuming the Mythic Keystone Season Index.

{
...
"season": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/season/4"
},
"id": 4
}
...
}


As mentioned above, a more direct way would be by consuming the Mythic Keystone Season Index (/data/wow/mythic-keystone/season/) and pulling the active season from 'current_season'.

{
"_links": {
"self": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/season/?namespace=dynamic-us"
}
},
"seasons": [
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/season/0?namespace=dynamic-us"
},
"id": 0
},
{
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/season/1?namespace=dynamic-us"
},
"id": 1
}
],
"current_season": {
"key": {
"href": "https://us.api.blizzard.com/data/wow/mythic-keystone/season/1?namespace=dynamic-us"
},
"id": 1
}
}


Does the above meet your use case?
Hey Comfort,

Were thrilled to hear you are all as excited about the new endpoints as we are!

To address some of your questions:

1) Do you know if "race" in the members document will be static after it is created, or will it change to reflect the user's race if they were to faction/race change? (like how "faction" in the keystone leaderboards document will change during a period).


Our understanding is that the race will be persisted with the run. Meaning that if a character were to undergo a race change, their race would remain unchanged in the run data as it shows in the Mythic Keystone Profile document.

2) Would it be possible to have the keystone leaderboards API also include these equipped_item_level / race fields for members of a group, just for consistency reasons? (Maybe it already does now and I just missed this?)


While we do not currently have any plans to add equipped_item_level or race data to the Mythic Keystone Leaderboards API documents, we've documented your request for future consideration.

3) If we have equipped_item_level in the document, would it be feasible to extend this to also include the actual gear they were snapshotted with? (I can imagine this might be a good bit of data bloat)


As you've suggested, our main concern with adding the actual snapshot of the gear which was equipped would be the amount of data that would need to be saved. With that, we do not currently have any plans to add this data, but we've documented your request for future consideration.

Thanks for all the great questions and feedback, keep them coming! :D
Hey Jimo,

11/13/2018 07:54 PMPosted by Jimo
Will the `current_period` object contain all of the data surrounding the current active season?


Does the above meet your use case?


It does! Thanks.
At a high level, we will be adding data that includes the seasonal best run for each dungeon. This data will include the seasonal best within qualifying time, as well as the seasonal best by Keystone level (in the event that the two runs are identical, only the seasonal best within qualifying time would be included in the data).


Hmm. Ist this best of list divided up to the affixes?

What is if i run an M+ Key 5 Tol Dagor with the simplest affix combination (intime) and next week an M10 Tol Dagor with the hardest possible (out of time)... only the M5 Key would be included i guess...

I guess the players want a full mplus statistic per period (not season) and not only the best of intime. Also an 24h api call (list all runs for player x for the last 24 hours or list all runs for dungeon Y (24h) would be much appreciated)
What is if i run an M+ Key 5 Tol Dagor with the simplest affix combination (intime) and next week an M10 Tol Dagor with the hardest possible (out of time)... only the M5 Key would be included i guess...


Your M+ Key 10 will still be included, it just will be included as the run with the highest keystone, instead of the run with the highest keystone within time.

This data will include the seasonal best within qualifying time, as well as the seasonal best by Keystone level...
But ..

in the event that the two runs are identical, only the seasonal best within qualifying time would be included in the data
Greetings undead,

Can you elaborate some more on your use case?

Is there a use case where you would want both runs to be included in the data, even though they have a identical keystone level, where one is within time and one is not within time (excluding use cases where it would be beneficial to have a historical listing of all M+ runs)?
Hello Maguthul.

sorry for my bad English.

Can you elaborate some more on your use case?


My personal use case is: I want build an guild m+ rooster.
For me as player… it’s frustrating to see… yes my run +10 KR is included but the +15 KR (finished but not in time) is not included.
Or.
my run +10 Temple is included but the +11 (finished but not in time with the hardest possible affix combo) is not included.

We run in the same situation before the api change:
To get really all runs… I have to scan the M Leaderboard Top 500. And guild groups with a low pop server… they will see all runs. Guild Groups on high population realms …. maybe all runs.

So for me… its important to see all runs intime (max key level) and also the runs out of time (max key level)

excluding use cases where it would be beneficial to have a historical listing of all M+ runs


Hmm.
In my opinion, the whole topic is just about historical data. And no.. it not required to get 2 years back. To catch the last 6 hours… (ALL runs) would be enough

Greetings
Hey there, I'm very happy about the new api endpoints. Could you say when they will be released. At the moment I only get a forbidden error message.

{"code":403,"type":"BLZWEBAPI00000403","detail":"Forbidden"}
Greetings all!

Please refer to our latest update here regarding these APIs.

Join the Conversation

Return to Forum