An unofficial player stats API for the Blizzard game "Overwatch" - Targetting .NET Standard 1.1 for maximum compatibility.

A simple web scraper that grabs player stats from a users PlayOverwatch.com profile and parses it to be used however you like. It's written entirely in C# using AngleSharp to parse the data from the page. The only limiting factor is the speed at which the PlayOverwatch profile can be loaded.

• Supports PC, Xbox 1 and Playstation 4 players.
• Entirely async operation
• Serializable - No complex data.
• Region detection - Easily find the correct region for a player.
• Platform detection - Detect which platform a player might play on.

• None at the moment - Any feature requests will be placed here.

• AngleSharp - Used to parse the data from the PlayOverwatch page as no other data source is available from Blizzard.

After you've added the necessary references to your project, using the library is incredibly simple.

The below code will create a new Overwatch player with the given Battletag, it will then detect the players region and update the users stats entirely asynchronously.

OverwatchPlayer player = new OverwatchPlayer("SirDoombox#2603");
await player.UpdateStatsAsync();
Double timePlayedInSeconds = player.CasualStats["AllHeroes"]["Game"]["Time Played"].Value;

You can cut down on some of the requests you need to make (and the time that those requests take up) by specifying the region at creation (if known). This snippet also uses .GetAwaiter().GetResult() to make the method run in a synchronous fashion.

OverwatchPlayer player = new OverwatchPlayer("SirDoombox#2603", Platform.pc, Region.eu);
player.UpdateStatsAsync().GetAwaiter().GetResult();
StatCategory statCategory = player.CasualStats["Junkrat"]["Hero Specific"];
foreach(var entry in statCategory)
{
  string statName = entry.Key;
  double statValue = entry.Value;
}

If you want to cut down on request timers and/or weigh the region detection in a certain way you are able to pass a RegionDetectionSettings object into the .UpdateStatsAsync() method. Note: The order in which you specify the regions is the order they will be checked in.

await player.UpdateStatsAsync(RegionDetectionSettings.Default);
// or...
await player.UpdateStatsAsync(new RegionDetectionSettings(Region.eu, Region.kr));

There are also some helper methods available for use to simplify some common operations

bool validTag = OverwatchAPIHelpers.IsValidBattletag("SomePlayer#1234"); // Returns true.
string profileUrl = OverwatchAPIHelpers.ProfileUrl("SomePlayer#1234", Region.eu); // Returns a PlayOverwatch profile URL.

Please see the "OverwatchDotNetTestbed" project if you'd like to see an implementation.

If you wish to contact me about contributing to the project, or have any questions / suggestions please feel free to come find me on the C# discord server. - @Doombox#0661

Please report any issues or bugs that you may find at your earliest convenience so I can get them fixed ASAP.