Introduction
Welcome to the OWAPI API. This API is based on Ovrstat by s32x
This API will be used in the Android Application OWidget 2. We recommend to use ow-api, but you can also use this API whenever you want.
I give no guarantee for the correctness of the sample data in this API, as this can always change.
This API documentation page was created with Slate.
Stats
Profile
curl https://owapi.eu/stats/pc/Domekologe-2110/profile
The above command returns JSON structured like this:
{
"icon": "https://d15f34w2p8l1cc.cloudfront.net/overwatch/93516aaaa83146516809a259e4bbf3373726eda3b5adbfda0c02c777ab600df6.png",
"name": "Domekologe",
"endorsement": 3,
"endorsementIcon": "https://static.playoverwatch.com/img/pages/career/icons/endorsement/3-8ccb5f0aef.svg#icon",
"title": Fearsome Spirit",
"ratings": [
{
"group": "Gold",
"tier": 1,
"role": "tank",
"roleIcon": "https://static.playoverwatch.com/img/pages/career/icons/role/tank-f64702b684.svg#icon",
"rankIcon": "https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-1-44f03fb9ca.png",
},
{
"group": "Gold",
"tier": 2,
"role": "offense",
"roleIcon": https://static.playoverwatch.com/img/pages/career/icons/role/offense-ab1756f419.svg#icon",
"rankIcon": https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-2-c8e5a08e32.png",
},
{
"group": "Gold",
"tier": 5,
"role": "support",
"roleIcon": "https://static.playoverwatch.com/img/pages/career/icons/role/support-0258e13d85.svg#icon",
"rankIcon": "https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-5-4f4894b821.png",
}
]
"private": false
}
This endpoint retrieves stats commonly used by bots and other services.
HTTP Request
GET https://owapi.eu/stats/:platform/:battletag/profile
URL Parameters
Parameter | Description |
---|---|
platform | The game platform (pc, console) |
battletag | Your battlenet tag (e.g. Domekologe-2110) |
Complete stats
curl https://owapi.eu/stats/pc/Domekologe-2110/complete
The above command returns JSON structured like this:
{
"icon": "https://d15f34w2p8l1cc.cloudfront.net/overwatch/93516aaaa83146516809a259e4bbf3373726eda3b5adbfda0c02c777ab600df6.png",
"name": "Domekologe",
"endorsement": 3,
"endorsementIcon": "https://static.playoverwatch.com/img/pages/career/icons/endorsement/3-8ccb5f0aef.svg#icon",
"title": Fearsome Spirit",
"ratings": [
{
"group": "Gold",
"tier": 1,
"role": "tank",
"roleIcon": "https://static.playoverwatch.com/img/pages/career/icons/role/tank-f64702b684.svg#icon",
"rankIcon": "https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-1-44f03fb9ca.png",
},
{
"group": "Gold",
"tier": 2,
"role": "offense",
"roleIcon": https://static.playoverwatch.com/img/pages/career/icons/role/offense-ab1756f419.svg#icon",
"rankIcon": https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-2-c8e5a08e32.png",
},
{
"group": "Gold",
"tier": 5,
"role": "support",
"roleIcon": "https://static.playoverwatch.com/img/pages/career/icons/role/support-0258e13d85.svg#icon",
"rankIcon": "https://static.playoverwatch.com/img/pages/career/icons/rank/GoldTier-5-4f4894b821.png",
}
],
"gamesPlayed": "5493",
"gamesWon": 2651,
"gamesLost": 2841,
"quickPlayStats": {
"eliminationsAvg": 11.77,
"damageDoneAvg": 5358,
"deathsAvg": 5.88,
"finalBlowsAvg": 5.6,
"healingDoneAvg": 1100,
"objectiveKillsAvg": 4.29,
"objectiveTimeAvg": "00:32",
"soloKillsAvg": 1.67,
"games": {
"played": 0,
"won": 716
},
"topHeroes": { ... },
"careerStats": { ... }
},
"competitiveStats": {
"eliminationsAvg": 22.25,
"damageDoneAvg": 12056,
"deathsAvg": 9.76,
"finalBlowsAvg": 11.76,
"healingDoneAvg": 2392,
"objectiveKillsAvg": 9.82,
"objectiveTimeAvg": "01:10",
"soloKillsAvg": 2.53,
"games": {
"played": 39,
"won": 18
},
"topHeroes": { ... },
"careerStats": { ... }
},
"private": false
}
This endpoint retrieves all profile data, including top heroes and career stats. It is a VERY heavy endpoint, and should only be used when you need all stats. Data returned is most of the time around 100KB.
HTTP Request
GET https://owapi.eu/stats/:platform/:battletag/complete
URL Parameters
Parameter | Description |
---|---|
platform | The game platform (pc, console) |
battletag | Your battlenet tag (e.g. Domekologe-2110) |
OWAPI uses the following error codes:
Error Code | Meaning |
---|---|
400 | Bad Request – Your request sucks |
404 | Not Found – The specified profile could not be found |
406 | Not Acceptable – You requested a format that isn’t json |
500 | Internal Server Error – We had a problem with our server. Try again later. |
503 | Service Unavailable – We’re temporarily offline for maintenance. Please try again later. |