Players

Search for players by name and retrieve their career statistics. These endpoints proxy data from Blizzard's official Overwatch website.

Search Players

GET/api/players/search

Search for an Overwatch player by their BattleTag nickname.

Query Parameters

name

string required

The player's username to search for (e.g., Turbotailz).

Example Request

curl "https://athena-api.pages.dev/api/players/search?name=Turbotailz"

const response = await fetch('https://athena-api.pages.dev/api/players/search?name=Turbotailz');
const data = await response.json();

Response Structure

Returns an array of matching players.

Note: Players with private profiles (isPublic: false) cannot have their stats queried.

[
  {
    "name": "Turbotailz",
    "url": "c64bbe88bc659aa4e5ea3aa1d506a108|7672a560b2985cb9deec233bb7663c74",
    "statsUrl": "https://athena-api.pages.dev/api/players/c64bbe88bc659aa4e5ea3aa1d506a108%7C7672a560b2985cb9deec233bb7663c74/stats",
    "avatar": "https://d15f34w2p8l1cc.cloudfront.net/overwatch/7e790435987163f9d51939106095393d1810757279373070445d4e4334f59c23.png",
    "title": "Player",
    "isPublic": true
  }
]

Get Player Stats

GET/api/players/:id/stats

Retrieve detailed career statistics for a specific player profile.

Note: This endpoint will return a 404 error if the player's profile is set to private or cannot be found.

Path Parameters

string required

The unique player identifier obtained from the search endpoint (the url field).

Example Request

curl "https://athena-api.pages.dev/api/players/c64bbe88bc659aa4e5ea3aa1d506a108%7C7672a560b2985cb9deec233bb7663c74/stats"

const playerId = "c64bbe88bc659aa4e5ea3aa1d506a108|7672a560b2985cb9deec233bb7663c74";
const response = await fetch(`https://athena-api.pages.dev/api/players/${encodeURIComponent(playerId)}/stats`);
const data = await response.json();

Response Structure

Returns the player's career profile, split into summary, Quick Play, and Competitive stats.

{
  "summary": {
    "name": "Turbotailz",
    "title": "Nomad",
    "endorsementLevel": "4"
  },
  "quickPlay": {
    "topHeroes": [
      {
        "category": "Time Played",
        "stats": [
          {
            "hero": "Ana",
            "value": "12 hours"
          }
        ]
      }
      // ...
    ],
    "careerStats": {
      "Ana": {
        "Eliminations": "1,234",
        "Assists": "5,678",
        "Deaths": "123"
        // ...
      }
      // ...
    }
  },
  "competitive": {
    "topHeroes": [],
    "careerStats": {}
  }
}