Search Player

API Documentation

Authentication

All API requests require your API key in the Authorization header:

Authorization: YOUR_API_KEY
Please login with Epic Games to generate an API key.

Player Stats Endpoints

GET /api/search?username={username}&platform={platform}
Look up a player's account ID by username. Platform options: epic, psn, xbl
{
  "account_id": "4735ce91-4292-4738-801d-9b834f11d8a9",
  "username": "Ninja",
  "platform": "epic"
}
GET /api/stats/{account_id}
Get comprehensive lifetime stats for a player by account ID.
{
  "stats": {
    "br_showdownalt_m0_playlist_showdownalt_solo": {
      "placetop1": 142,
      "kills": 3847,
      "matchesplayed": 2156,
      "placetop10": 891,
      "placetop25": 1203,
      "score": 847293
    }
  },
  "stats_by_input": {
    "gamepad": { ... },
    "keyboardmouse": { ... }
  }
}
GET /api/all-data/{account_id}
Get all player data including stats, ranked progress, and metadata.
{
  "stats": { ... },
  "ranked": { ... },
  "account": {
    "displayName": "Ninja",
    "externalAuths": { ... }
  }
}
GET /api/lookup/{display_name}?platform={platform}
Get account ID from display name. Supports Epic, PSN, and Xbox lookups.
{
  "account_id": "4735ce91-4292-4738-801d-9b834f11d8a9",
  "display_name": "Ninja",
  "platform": "epic"
}

Ranked Endpoints

GET /api/ranked-progress/{account_id}
Get a player's ranked progression across all modes (BR, Zero Build, Reload, etc.)
{
  "accountId": "4735ce91-4292-4738-801d-9b834f11d8a9",
  "enroll": {
    "subGames": ["Fortnite", "DelMar"]
  },
  "rankedProgress": [
    {
      "rankingType": "ranked-br",
      "currentDivision": 15,
      "promotionProgress": 87.5,
      "highestDivision": 18,
      "globalRank": 1234
    },
    {
      "rankingType": "ranked-zb",
      "currentDivision": 17,
      "promotionProgress": 45.2,
      "highestDivision": 17
    }
  ]
}
GET /api/ranked-search?username={username}
Search for a player and get their ranked data in one request.
{
  "accountId": "4735ce91-4292-4738-801d-9b834f11d8a9",
  "displayName": "Ninja",
  "rankedData": {
    "rankedProgress": [
      {
        "rankingType": "ranked-br",
        "currentDivision": 18,
        "promotionProgress": 0,
        "globalRank": 42
      }
    ]
  }
}
GET /api/ranked-leaderboard?mode={mode}&limit={limit}&offset={offset}
Get global ranked leaderboard. Modes: ranked-br, ranked-zb, ranked-reload, ranked-pimlico (Crown Jam)
{
  "players": [
    {
      "account_id": "abc123...",
      "display_name": "ProPlayer1",
      "division": 18,
      "division_name": "Unreal",
      "promotion_progress": 0,
      "global_rank": 1
    }
  ],
  "distribution": {
    "18": 152,
    "17": 2341,
    "16": 8923
  },
  "total": 45231
}
GET /api/top-ranked-players?limit={limit}
Get top Unreal-ranked players with their rank icons.
{
  "players": [
    {
      "account_id": "abc123...",
      "display_name": "TopPlayer",
      "division": 18,
      "division_name": "Unreal",
      "global_rank": 1,
      "rank_type": "ranked-br",
      "icon_url": "/ranks/18.png"
    }
  ]
}

Leaderboard Endpoints

GET /api/leaderboard?stat={stat}&gamemode={gamemode}&modeType={modeType}&page={page}
Get global stats leaderboard. Stats: wins, kills, kd. Gamemodes: all, solo, duo, squad. Mode types: all, br, zb
{
  "players": [
    {
      "rank": 1,
      "display_name": "TopKiller",
      "account_id": "xyz789...",
      "value": 125432,
      "stat": "kills"
    }
  ],
  "page": 1,
  "total_pages": 50,
  "total_players": 2500
}
GET /api/top-stats-players?stat={stat}&limit={limit}
Get top players by a specific stat. Stats: wins, kills, kd, winrate
{
  "players": [
    {
      "display_name": "WinMachine",
      "account_id": "abc123...",
      "value": 8432,
      "stat": "wins"
    }
  ]
}

Division Reference

Ranked divisions are numbered 0-18:

0  = Unranked
1-3 = Bronze I, II, III
4-6 = Silver I, II, III
7-9 = Gold I, II, III
10-12 = Platinum I, II, III
13-15 = Diamond I, II, III
16 = Elite
17 = Champion
18 = Unreal