NGS Player Profile Endpoint


This endpoint is used for getting an NGS players stats. The following attributes are returned.

{
  "wins": "wins",
  "losses": "losses",
  "avg_level": "avg_level",
  "avg_kills": "avg_kills",
  "total_kills": "total_kills",
  "avg_assists": "avg_assists",
  "total_assists": "total_assists",
  "avg_takedowns": "avg_takedowns",
  "total_takedowns": "total_takedowns",
  "avg_deaths": "avg_deaths",
  "total_deaths": "total_deaths",
  "kda": "kda",
  "avg_highest_kill_streak": "avg_highest_kill_streak",
  "avg_hero_damage": "avg_hero_damage",
  "avg_siege_damage": "avg_siege_damage",
  "avg_structure_damage": "avg_structure_damage",
  "avg_minion_damage": "avg_minion_damage",
  "avg_creep_damage": "avg_creep_damage",
  "avg_summon_damage": "avg_summon_damage",
  "avg_time_cc_enemy_heroes": "avg_time_cc_enemy_heroes",
  "avg_healing": "avg_healing",
  "avg_self_healing": "avg_self_healing",
  "avg_damage_taken": "avg_damage_taken",
  "avg_experience_contribution": "avg_experience_contribution",
  "avg_town_kills": "avg_town_kills",
  "avg_time_spent_dead": "avg_time_spent_dead",
  "avg_merc_camp_captures": "avg_merc_camp_captures",
  "avg_watch_tower_captures": "avg_watch_tower_captures",
  "avg_meta_experience": "avg_meta_experience",
  "avg_protection_allies": "avg_protection_allies",
  "avg_silencing_enemies": "avg_silencing_enemies",
  "avg_rooting_enemies": "avg_rooting_enemies",
  "avg_stunning_enemies": "avg_stunning_enemies",
  "avg_clutch_heals": "avg_clutch_heals",
  "avg_escapes": "avg_escapes",
  "avg_vengeance": "avg_vengeance",
  "avg_outnumbered_deaths": "avg_outnumbered_deaths",
  "avg_teamfight_escapes": "avg_teamfight_escapes",
  "avg_teamfight_healing": "avg_teamfight_healing",
  "avg_teamfight_damage_taken": "avg_teamfight_damage_taken",
  "avg_teamfight_hero_damage": "avg_teamfight_hero_damage",
  "avg_multikill": "avg_multikill",
  "avg_physical_damage": "avg_physical_damage",
  "avg_spell_damage": "avg_spell_damage",
  "avg_regen_globes": "avg_regen_globes",
  "kill_participation": kill_participation,
  "top_three_heroes": [
    "hero",
    "hero",
    "hero"
  ],
  "heroes_played": heroes_played,
  "preferred_role": "preferred_role"
}

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 NGS/Player/Profile?battletag=Zemill%231940&region=1 Default
GET NGS/Player/Profile?battletag=Zemill%231940&region=1&season=6 Default
GET NGS/Player/Profile?battletag=Zemill%231940&region=1&season=6&division=C%20West Default

URL Parameters (required)

battletag: (Full battletag) - url encoded.

region: (1 = NA, 2 = EU, 3 = KR, 5 = CN).  Use 1 for NGS.

URL Parameters (as needed)

season: An NGS season. (6 or 7).

division: The NGS division the player is in for the season chosen.

Example Return

{
  "wins": "1",
  "losses": "2",
  "avg_level": "17.3333",
  "avg_kills": "1.0000",
  "total_kills": "3",
  "avg_assists": "2.0000",
  "total_assists": "6",
  "avg_takedowns": "3.0000",
  "total_takedowns": "9",
  "avg_deaths": "3.3333",
  "total_deaths": "10",
  "kda": "0.9000",
  "avg_highest_kill_streak": "1.6667",
  "avg_hero_damage": "33045.0000",
  "avg_siege_damage": "86465.6667",
  "avg_structure_damage": "7511.6667",
  "avg_minion_damage": "76017.3333",
  "avg_creep_damage": "16194.0000",
  "avg_summon_damage": "2936.6667",
  "avg_time_cc_enemy_heroes": "41.3333",
  "avg_healing": "3232.0000",
  "avg_self_healing": "13902.6667",
  "avg_damage_taken": "33069.3333",
  "avg_experience_contribution": "8052.3333",
  "avg_town_kills": "0.6667",
  "avg_time_spent_dead": "104.3333",
  "avg_merc_camp_captures": "3.0000",
  "avg_watch_tower_captures": "0.0000",
  "avg_meta_experience": "60240.6667",
  "avg_protection_allies": "0.0000",
  "avg_silencing_enemies": "6.3333",
  "avg_rooting_enemies": "0.0000",
  "avg_stunning_enemies": "3.6667",
  "avg_clutch_heals": "0.0000",
  "avg_escapes": "0.3333",
  "avg_vengeance": "0.0000",
  "avg_outnumbered_deaths": "3.0000",
  "avg_teamfight_escapes": "0.0000",
  "avg_teamfight_healing": "0.0000",
  "avg_teamfight_damage_taken": "25804.3333",
  "avg_teamfight_hero_damage": "21359.0000",
  "avg_multikill": "0.6667",
  "avg_physical_damage": "31354.3333",
  "avg_spell_damage": "103140.3333",
  "avg_regen_globes": "26.3333",
  "kill_participation": 55.55555555555555,
  "top_three_heroes": [
    "Alarak",
    "Ragnaros",
    "Kerrigan"
  ],
  "heroes_played": 3,
  "preferred_role": "Melee Assassin"
}