Player Replay Endpoint


This endpoint is used for gathering player replay data. The following attributes are returned.

{
    "game_type": {
        "replayID": {
          "game_date": "game_date",
          "game_length": game_length,
          "game_map": "game_map",
          "game_version": "game_version",
          "region": region,
          "hero": "hero",
          "hero_level": hero_level,
          "mastery_taunt": mastery_taunt,
          "team": team,
          "winner": winner,
          "party": "party",
          "player_mmr": player_mmr,
          "hero_mmr": hero_mmr,
          "role_mmr": role_mmr,
          "mmr_date_parsed": "mmr_date_parsed",
          "level_one": "level_one",
          "level_four": "level_four",
          "level_seven": "level_seven",
          "level_ten": "level_ten",
          "level_thirteen": "level_thirteen",
          "level_sixteen": "level_sixteen",
          "level_twenty": "level_twenty",
          "level": level,
          "kills": kills,
          "assists": assists,
          "takedowns": takedowns,
          "deaths": deaths,
          "highest_kill_streak": highest_kill_streak,
          "hero_damage": hero_damage,
          "siege_damage": siege_damage,
          "structure_damage": structure_damage,
          "minion_damage": minion_damage,
          "creep_damage": creep_damage,
          "summon_damage": summon_damage,
          "time_cc_enemy_heroes": time_cc_enemy_heroes,
          "healing": healing,
          "self_healing": self_healing,
          "damage_taken": damage_taken,
          "experience_contribution": experience_contribution,
          "town_kills": town_kills,
          "time_spent_dead": time_spent_dead,
          "merc_camp_captures": merc_camp_captures,
          "watch_tower_captures": watch_tower_captures,
          "meta_experience": meta_experience,
          "match_award": match_award,
          "protection_allies": protection_allies,
          "silencing_enemies": silencing_enemies,
          "rooting_enemies": rooting_enemies,
          "stunning_enemies": stunning_enemies,
          "clutch_heals": clutch_heals,
          "escapes": escapes,
          "vengeance": vengeance,
          "outnumbered_deaths": outnumbered_deaths,
          "teamfight_escapes": teamfight_escapes,
          "teamfight_healing": teamfight_healing,
          "teamfight_damage_taken": teamfight_damage_taken,
          "teamfight_hero_damage": teamfight_hero_damage,
          "multikill": multikill,
          "physical_damage": physical_damage,
          "spell_damage": spell_damage,
          "regen_globes": regen_globes,
          "first_to_ten": first_to_ten
      }
  }
}

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 /Player/Replays?battletag=Zemill%231940&region=1 Default
GET /Player/Replays?battletag=Zemill%231940&region=1&game_type=Storm League Default
GET /Player/Replays?battletag=Zemill%231940&region=1&game_type=Storm League&hero=Abathur Default

URL Parameters (required)

mode: (json or csv)

battletag: (Full battletag) - url encoded

region:  (1 = NA, 2 = EU, 3 = KR, 5 = CN)

URL Parameters (as needed)

game_type: Full game type.  e.g.  Storm League

hero: Full hero name.  e.g.  Abathur

Example Return

{
"Hero League": {
    "1701807": {
        "game_date": "2016-06-25 07:13:01",
        "game_length": 1540,
        "game_map": "Blackheart's Bay",
        "hero": "Zagara",
        "hero_level": 10,
        "mastery_taunt": null,
        "team": 0,
        "winner": false,
        "party": "",
        "player_mmr": 1742.4302356931885,
        "hero_mmr": 1745.2031331273204,
        "role_mmr": 1741.3738192170915,
        "mmr_date_parsed": "2019-06-29 10:35:21",
        "level_one": "",
        "level_four": "",
        "level_seven": "Endless Creep",
        "level_ten": "Devouring Maw",
        "level_thirteen": "",
        "level_sixteen": "Brood Expansion",
        "level_twenty": "Bolt of the Storm",
        "level": 21,
        "kills": 2,
        "assists": 3,
        "takedowns": 5,
        "deaths": 2,
        "highest_kill_streak": 0,
        "hero_damage": 59855,
        "siege_damage": 81195,
        "structure_damage": 5174,
        "minion_damage": 71503,
        "creep_damage": 32099,
        "summon_damage": 4518,
        "time_cc_enemy_heroes": 58,
        "healing": null,
        "self_healing": 3695,
        "damage_taken": null,
        "experience_contribution": 14360,
        "town_kills": 1,
        "time_spent_dead": 78,
        "merc_camp_captures": 3,
        "watch_tower_captures": 0,
        "meta_experience": 82321,
        "match_award": null,
        "protection_allies": null,
        "silencing_enemies": null,
        "rooting_enemies": null,
        "stunning_enemies": null,
        "clutch_heals": null,
        "escapes": null,
        "vengeance": null,
        "outnumbered_deaths": null,
        "teamfight_escapes": null,
        "teamfight_healing": null,
        "teamfight_damage_taken": null,
        "teamfight_hero_damage": null,
        "multikill": null,
        "physical_damage": null,
        "spell_damage": null,
        "regen_globes": null,
        "first_to_ten": null
        }
    }
}