Player Pre-Match Endpoint


This endpoint is used for gathering player pre-match 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/PreMatch?mode=json&battletag=Zemill%231940&region=1 Default
GET /Player/PreMatch?mode=json&battletag=Zemill%231940&region=1&game_type=Storm League&hero=Abathur Default
GET /Player/PreMatch?mode=csv&battletag=Zemill%231940&region=1&game_type=Storm League Default
POST /Player/PreMatch Default

URL/Data Parameters (required)

mode: (json or csv)

battletag:  (Full battletag) - url encoded

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

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

URL/Data Parameters (as needed)

game_map: Full game map. e.g. Sky Temple

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
        },
        "4755634": {
        "game_date": "2016-06-26 13:13:34",
        "game_length": 1114,
        "game_map": "Towers of Doom",
        "hero": "Tassadar",
        "hero_level": 9,
        "mastery_taunt": null,
        "team": 0,
        "winner": true,
        "party": "",
        "player_mmr": 1844.3933487254633,
        "hero_mmr": 1902.717626342534,
        "role_mmr": 1903.8696083082768,
        "mmr_date_parsed": "2019-06-29 11:04:50",
        "level_one": "Conjurer's Pursuit",
        "level_four": "",
        "level_seven": "",
        "level_ten": "Force Wall",
        "level_thirteen": "Shrink Ray",
        "level_sixteen": "",
        "level_twenty": "Storm Shield",
        "level": 21,
        "kills": 2,
        "assists": 17,
        "takedowns": 19,
        "deaths": 2,
        "highest_kill_streak": 0,
        "hero_damage": 24464,
        "siege_damage": 42073,
        "structure_damage": 7898,
        "minion_damage": 20822,
        "creep_damage": 15721,
        "summon_damage": 13353,
        "time_cc_enemy_heroes": 24,
        "healing": 41537,
        "self_healing": 2366,
        "damage_taken": null,
        "experience_contribution": 11948,
        "town_kills": 3,
        "time_spent_dead": 68,
        "merc_camp_captures": 4,
        "watch_tower_captures": 0,
        "meta_experience": null,
        "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
        }
        },
        "Quick Match": {
        "3077694": {
        "game_date": "2016-07-03 23:13:01",
        "game_length": 1212,
        "game_map": "Blackheart's Bay",
        "hero": "Rehgar",
        "hero_level": 6,
        "mastery_taunt": null,
        "team": 1,
        "winner": true,
        "party": "",
        "player_mmr": 1877.7710258928669,
        "hero_mmr": 1906.80309819983,
        "role_mmr": 1896.8687637346711,
        "mmr_date_parsed": "2019-06-29 13:33:14",
        "level_one": "Colossal Totem",
        "level_four": "Feral Heart",
        "level_seven": "Blood and Thunder",
        "level_ten": "Ancestral Healing",
        "level_thirteen": "Earthliving Enchant",
        "level_sixteen": "Earthgrasp Totem",
        "level_twenty": "Storm Shield",
        "level": 21,
        "kills": 0,
        "assists": 6,
        "takedowns": 6,
        "deaths": 1,
        "highest_kill_streak": 0,
        "hero_damage": 12106,
        "siege_damage": 23589,
        "structure_damage": 4956,
        "minion_damage": 17327,
        "creep_damage": 34544,
        "summon_damage": 1306,
        "time_cc_enemy_heroes": 240,
        "healing": 53977,
        "self_healing": 0,
        "damage_taken": null,
        "experience_contribution": 8841,
        "town_kills": 0,
        "time_spent_dead": 65,
        "merc_camp_captures": 11,
        "watch_tower_captures": 2,
        "meta_experience": 89890,
        "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
        },
        "4031917": {
        "game_date": "2016-07-13 20:13:40",
        "game_length": 1114,
        "game_map": "Dragon Shire",
        "hero": "Li-Ming",
        "hero_level": 15,
        "mastery_taunt": null,
        "team": 0,
        "winner": false,
        "party": "",
        "player_mmr": 1850.7125463622892,
        "hero_mmr": 1766.2951574976576,
        "role_mmr": 1775.7339053631424,
        "mmr_date_parsed": "2019-06-29 16:49:58",
        "level_one": "Power Hungry",
        "level_four": "Dominance",
        "level_seven": "Seeker",
        "level_ten": "Disintegrate",
        "level_thirteen": "Glass Cannon",
        "level_sixteen": "Mirrorball",
        "level_twenty": "Temporal Flux",
        "level": 21,
        "kills": 4,
        "assists": 5,
        "takedowns": 9,
        "deaths": 8,
        "highest_kill_streak": 0,
        "hero_damage": 24875,
        "siege_damage": 82311,
        "structure_damage": 14088,
        "minion_damage": 60247,
        "creep_damage": 0,
        "summon_damage": 7976,
        "time_cc_enemy_heroes": 63607,
        "healing": null,
        "self_healing": 1395,
        "damage_taken": null,
        "experience_contribution": 11885,
        "town_kills": 0,
        "time_spent_dead": 322,
        "merc_camp_captures": 0,
        "watch_tower_captures": 0,
        "meta_experience": null,
        "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
        },
        "9985501": {
        "game_date": "2016-07-17 23:39:34",
        "game_length": 1160,
        "game_map": "Dragon Shire",
        "hero": "Rehgar",
        "hero_level": 6,
        "mastery_taunt": null,
        "team": 0,
        "winner": true,
        "party": "",
        "player_mmr": 2064.453788824809,
        "hero_mmr": 2010.879031496257,
        "role_mmr": 2033.4619947013337,
        "mmr_date_parsed": "2019-06-29 18:23:20",
        "level_one": "Colossal Totem",
        "level_four": "Feral Heart",
        "level_seven": "Blood and Thunder",
        "level_ten": "Ancestral Healing",
        "level_thirteen": "Earthliving Enchant",
        "level_sixteen": "Earthgrasp Totem",
        "level_twenty": "Storm Shield",
        "level": 22,
        "kills": 4,
        "assists": 14,
        "takedowns": 18,
        "deaths": 4,
        "highest_kill_streak": 0,
        "hero_damage": 16356,
        "siege_damage": 56922,
        "structure_damage": 17695,
        "minion_damage": 30839,
        "creep_damage": 10138,
        "summon_damage": 8388,
        "time_cc_enemy_heroes": 227,
        "healing": 59259,
        "self_healing": 0,
        "damage_taken": null,
        "experience_contribution": 12396,
        "town_kills": 0,
        "time_spent_dead": 105,
        "merc_camp_captures": 2,
        "watch_tower_captures": 0,
        "meta_experience": 96242,
        "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
        }
    }
}