overwatcher provides API for accessing Overwatch
League statistics on match, map and
player level.
The API answers some typical problems
-
Which season 4 player is the best tracer in terms of average damage and sticky bomb hits? (
/player_stats) -
What is the total earnings for US owl players, and how much is it related to age? (
/player_info) -
As season proceeds, how does sombra players evolve on EMP efficiency? (
/matches) -
In which match did two CP maps have the longest round duration and greatest number of rounds? (
/maps)
The data comes from two sources:
-
Overwatch League Stats Lab including match and map statistics for all 4 seasons, currently only season 4 match statistics is presented in the app
-
Liquipedia Player Wiki including players’ personal information
All API endpoints and swagger docs are implemented in Python’s FastAPI framework. Data cleaning and scraping is done in R with data.table.
When it comes to match statistics, there are 3 important query parameters to pre-filter data and limit the analysis scope: stat, hero and map. For example, we may be interested to know how fleta’s performance on tracer in Ilios, specifically, the average played time, damage and time alive. Then we can set query parameters on swagger as
This generates curl commands
curl -X 'GET' \
'https://overwatcher-stat.herokuapp.com/player_stat/fleta?stat=all%20damage%20done&stat=time%20alive&stat=time%20played&hero=tracer&map=ilios' \
-H 'accept: application/json'There is also a POST version of the same request:
curl -X 'POST' \
'https://overwatcher-stat.herokuapp.com/player_stats' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"names": "fleta",
"stats": [
"all damage done",
"time played",
"time alive",
],
"heroes": "tracer",
"maps": "ilios"
}'Below is a list of all available values ordered alphabetically for some query parameters. Note that all values should be lowercase.
all heroesanaashebaptistebastionbrigitted.vadoomfistechogenjihanzojunkratluciomccreemeimercymoiraorisapharahreaperreinhardtroadhogsigmasoldier: 76sombrasymmetratorbjorntracerwidowmakerwinstonwrecking ballzaryazenyatta
blizzard worldbusandoradoeichenwaldehanamurahavanahollywoodiliosjunkertownking's rowlijiang towernepalnumbanioasisrialtoroute 66temple of anubisvolskaya industrieswatchpoint: gibraltar
ability damage doneaccretion killsaccretion stunsadaptive shield usesair uptimeair uptime percentageall damage doneamped heal activationsamped speed activationsamplification matrix assistsamplification matrix castsamplification matrix efficiencyarmor - rallyarmor providedassistsaverage energyaverage players per teleporteraverage time alivebarrage efficiencybarrage killsbarrier damage donebiotic field healing donebiotic fields deployedbiotic grenade killsbiotic launcher healing explosionsbiotic launcher healing shotsbiotic orb damage efficiencybiotic orb healing efficiencybiotic orb maximum damagebiotic orb maximum healingblaster killsblizzard efficiencyblizzard killsbob gun damagebob killscharge killscoach gun killscoalescence healingcoalescence killscoalesence - damage per usecoalesence - healing per useconcussion mine killscritical hit accuracycritical hit killscritical hitsdamage - accretiondamage - barragedamage - biotic grenadedamage - biotic orbdamage - blizzarddamage - bobdamage - bob chargedamage - boostersdamage - call mechdamage - chain hookdamage - chargedamage - coach gundamage - coalescencedamage - concussion minedamage - deadeyedamage - death blossomdamage - deflectdamage - discord orbdamage - dragonbladedamage - dragonblade totaldamage - dragonstrikedamage - duplicatedamage - dynamitedamage - earthshatterdamage - empdamage - fire strikedamage - flashbangdamage - focusing beamdamage - focusing beam - bonus damage onlydamage - grappling clawdamage - graviton surgedamage - helix rocketsdamage - hyperspheresdamage - jump packdamage - meteor strikedamage - micro missilesdamage - minefielddamage - molten coredamage - piledriverdamage - pistoldamage - primal rage leapdamage - primal rage meleedamage - primal rage totaldamage - pulse bombdamage - quick meleedamage - rip-tiredamage - rising uppercutdamage - rocket punchdamage - seismic slamdamage - self destructdamage - sentry turretdamage - shield bashdamage - sonicdamage - steel trapdamage - sticky bombsdamage - storm arrowsdamage - swift strikedamage - swift strike dragonbladedamage - tactical visordamage - total mayhemdamage - venom minedamage - weapondamage - weapon chargeddamage - weapon hammerdamage - weapon pistoldamage - weapon primarydamage - weapon recondamage - weapon scopeddamage - weapon secondarydamage - weapon sentrydamage - weapon tankdamage - whole hogdamage absorbeddamage amplifieddamage blockeddamage donedamage preventeddamage reflecteddamage takendamage taken - adaptive shielddamage taken - balldamage taken - tankdeadeye efficiencydeadeye killsdeath blossom efficiencydeath blossom killsdeath blossomsdeathsdefensive assistsdeflection killsdirect hit accuracydiscord orb timedragonblade efficiencydragonblade killsdragonbladesdragonstrike efficiencydragonstrike killsduplicate killsdynamite killsearthshatter efficiencyearthshatter killsearthshatter stunseliminationsemp efficiencyenemies emp'denemies frozenenemies hackedenemies hookedenemies sleptenemies trappedenergy maximumenvironmental deathsenvironmental killsfan the hammer killsfinal blowsfire strike killsfocusing beam accuracyfocusing beam dealing damage secondsfocusing beam killsfocusing beam secondsfrag launcher direct hitsfreeze spray damagegrappling claw impactsgrappling claw killsgrappling claw usesgravitic flux damage donegravitic flux killsgraviton surge efficiencygraviton surge killshammer killsharmony orb timeheal song time elapsedhealing - biotic grenadehealing - biotic launcherhealing - biotic orbhealing - coalescencehealing - harmony orbhealing - healing boosthealing - healing boost ampedhealing - immortality fieldhealing - inspirehealing - regenerative bursthealing - repair packhealing - secondary firehealing - transcendencehealing - weaponhealing - weapon scopedhealing - weapon valkyriehealing accuracyhealing amplifiedhealing donehealing receivedhealth recoveredhelix rocket killshero damage donehigh energy killshook accuracyhooks attemptedhyperspheres direct hitsicicle damageimmortality field deaths preventedinfra-sight efficiencyinfra-sight uptimeinspire uptimeinspire uptime percentagejump pack killsknockback killslifetime energy accumulationmatch blinks usedmech deathsmechs calledmelee final blowsmelee killsmelee percentage of final blowsmeteor strike efficiencymeteor strike killsminefield killsmolten core efficiencymolten core killsmultikillsnano boost assistsnano boost efficiencynano boosts appliedobjective killsobjective timeof rockets firedoffensive assistsoverload killsphoton projector killspiledriver killspiledriver usesplayers haltedplayers knocked backplayers resurrectedplayers savedplayers teleportedprimal rage efficiencyprimal rage killsprimal rage melee accuracyprimal rage melee efficiencyprimal rage melee hitsprimal rage melee hits - multipleprimal rage melee ticksprimary fire accuracyprimary fire average levelprimary fire hitsprimary fire hits hits - levelprimary fire ticksprojected barrier damage blockedprojected barriers appliedpulse bomb attach ratepulse bomb efficiencypulse bomb killspulse bombs attachedquick melee accuracyquick melee hitsquick melee ticksrally armor efficiencyrecalls usedrecon assistsrecon killsrip-tire efficiencyrip-tire killsrocket barragesrocket direct hitsrocket hammer melee accuracyrocket hammer melee average targetsrocket hammer melee hitsrocket hammer melee hits - multiplerocket hammer melee ticksroll uptimeroll uptime percentageroll usesscoped accuracyscoped critical hit accuracyscoped critical hit killsscoped critical hitsscoped hitsscoped shotssecondary direct hitssecondary fire accuracysecondary fire hitssecondary fire ticksself destruct efficiencyself healingself healing percent of damage takenself-destruct killsself-destructssentry killssentry turret killsshielding - adaptive shieldshields createdshots firedshots hitshots missedsleep dart hitssleep dart shotssleep dart success ratesolo killssound barrier castssound barrier efficiencysound barriers providedsoundwave killsspeed song time elapsedsticky bombs direct hit accuracysticky bombs direct hitssticky bombs killssticky bombs usedsstorm arrow killssuccessful freezessupercharger assistssupercharger efficiencytactical visor efficiencytactical visor killstactical visorstank efficiencytank killsteleporter pads destroyedteleporter uptimeteleporters placedtesla cannon accuracytesla cannon efficiencytesla cannon hitstesla cannon hits - multipletesla cannon tickstime alivetime building ultimatetime discordedtime elapsed per ultimate earnedtime hackedtime holding ultimatetime playedtorbjörn killstotal mayhem killstotal time frozentranscendence efficiencytranscendence healingtranscendence percent of healingturret damageturret killsturrets destroyedultimates earned - fractionalultimates negatedultimates usedunscoped accuracyunscoped hitsunscoped shotsvalkyrie healing efficiencyvenom mine killsweapon accuracyweapon killswhole hog efficiencywhole hog kills
alarmamenganamoansansoonjaearchitectaspireassassinaztacbeastbebebernarbiancabirdringblasebqbcarpechangsikcheckmatechoihyobinchoisehwanclosercoldestcolourhexcr0ngcreativecrimzodaandaltondantehdecaydevelopdiemdohadreamerdridroedisoneileenellivoteelsaeqofaithfarway1987fatefdgodfearlessfeath5rfielderfirefitsfletaflorafrdwnrfridayfunnyastrofuryga9agaebullssigangnamjingargoylegatorgestureglistergodsbguxuegwangboonghadihanbinhappyhawkheesuhighbeehotbahybridhydrationidkim37ir1sivyizayakijakejecsejerryjihunjimmyjinmujjanggujjonakjoobikaankaikalioskanekikarivkellexkevsterkrystalksflastrolateyoungleaveleejaegonlinkzrliplogixm1kamagmandumanomarve1masaamcdmichellemirrormmonkmolanranmolf1gmollymothmuzemykayleemyunb0ngna1stnaganeptunoneronishaogeonigodpelicanpiggyprofitpunkrapelrascalrioriparoolfsadoseominsooshaxshockwaveshowchengshredlockshushysilver3skewedslimesmurfsp9rk1espacesparkrstand1strikersuperta1yotakoyakitarocook1eterutobitoyoutsunattubatwilightvalentinevestolaviol2tvoidwhoruwyayakiyakpungyveltal
(Starting from the third stage, owl stats lab did not distinguish between regular season and playoffs)
season2 stage2season2 stage4season2 playoffseason4season1 stage3season1 playoffseason2 stage2 titleseason1 stage2season2 stage1 titleseason1 stage4season3season2 stage3 titleseason1 stage1 titleseason2 stage1season1 stage1season2 stage3
assaulthybridcontrolpayload