NGS Match Endpoint

This endpoint is used for getting Match data.

{
  {
    "season": season,
    "division": "division",
    "team": "requested team",
    "team_map_bans": ["ban1", "ban2"],
    "enemy": "enemy team",
    "enemy_map_bans": ["ban1", "ban2"],
    "round": round,
    "total_games": total games,
    "match_data": {
      "1": {
        "map": "map",
        "length": game length in seconds,
        "winner": winner,
        "team_heroes": ["Hero 1", "Hero 2", "Hero 3", "Hero 4", "Hero 5"],
        "team_bans": ["Ban 1", "Ban 2", "Ban 3"],
        "enemy_heroes": ["Hero 1", "Hero 2", "Hero 3", "Hero 4", "Hero 5"],
        "enemy_bans": ["Ban 1", "Ban 2", "Ban 3"],
        "replay_url": "replay url"
      }
    }
  }
}

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

URL Parameters (required)

season: NGS season.

division: NGS Division.

team: NGS Team.

round:  Match round

Example Return

{
  {
    "season": "9",
    "division": "Heroic",
    "team": "Quaranteam",
    "team_map_bans": [
      "Braxis Holdout",
      "Dragon Shire"
    ],
    "enemy": "Anti-Clown Association",
    "enemy_map_bans": [
      "Alterac Pass",
      "Sky Temple"
    ],
    "round": "1",
    "total_games": 3,
    "match_data": {
      "1": {
        "map": "Volskaya Foundry",
        "length": 1748,
        "winner": false,
        "team_heroes": [
          "Li-Ming",
          "Stukov",
          "E.T.C.",
          "Blaze",
          "Greymane"
        ],
        "team_bans": [
          "Chen",
          "Chromie",
          "Deathwing"
        ],
        "enemy_heroes": [
          "Sylvanas",
          "Johanna",
          "Samuro",
          "Mephisto",
          "Lúcio"
        ],
        "enemy_bans": [
          "Xul",
          "Ana",
          "Yrel"
        ],
        "replay_url": "https://www.heroesprofile.com/NGS/Match/Single/?replayID=3565"
      },
      "2": {
        "map": "Infernal Shrines",
        "length": 1013,
        "winner": true,
        "team_heroes": [
          "Maiev",
          "Rehgar",
          "Johanna",
          "Zeratul",
          "Hanzo"
        ],
        "team_bans": [
          "Stukov",
          "Tyrael",
          "Deathwing"
        ],
        "enemy_heroes": [
          "Raynor",
          "Uther",
          "Blaze",
          "Mephisto",
          "Ana"
        ],
        "enemy_bans": [
          "Greymane",
          "Sylvanas",
          "Xul"
        ],
        "replay_url": "https://www.heroesprofile.com/NGS/Match/Single/?replayID=3566"
      },
      "3": {
        "map": "Towers of Doom",
        "length": 1178,
        "winner": true,
        "team_heroes": [
          "Greymane",
          "Lúcio",
          "Diablo",
          "Deathwing",
          "Falstad"
        ],
        "team_bans": [
          "Malthael",
          "Raynor",
          "Xul"
        ],
        "enemy_heroes": [
          "Valla",
          "Tyrael",
          "Leoric",
          "Li-Ming",
          "Rehgar"
        ],
        "enemy_bans": [
          "Johanna",
          "Sylvanas",
          "Zeratul"
        ],
        "replay_url": "https://www.heroesprofile.com/NGS/Match/Single/?replayID=3567"
      }
    }
  }
}