Rankings

Retrieve player performance rankings with advanced stats sourced from Bo3.gg and PandaScore.

API Endpoint

GET/v6/esports/{discipline}/rankings

Parameters

ParameterTypeRequiredDescription
disciplinestringGame slug: cs2, valorant, lol, dota-2
sort_bystringSort field: rating, kills, kd_ratio
timeframestringTime range: 30d, 90d, year
limitintegerMax results (default: 50, max: 200)

Example URLs

CS2 top players by rating:

/v6/esports/cs2/rankings?sort_by=rating&limit=20

Valorant rankings last 30 days:

/v6/esports/valorant/rankings?timeframe=30d

Example Response

Response
[
  {
    "rank": 1,
    "team": "FaZe Clan",
    "points": 1000,
    "change": 0
  },
  {
    "rank": 2,
    "team": "G2 Esports",
    "points": 950,
    "change": 1
  }
]

Response Fields

FieldTypeDescription
avg_player_ratingfloat HLTV-style rating (6.5+ is elite)
avg_kd_ratefloatAverage Kill/Death ratio
avg_headshot_kills_accuracyfloatPercentage of kills that were headshots
multikills_vs_5integerTotal number of Aces (5K) recorded
clutches_vs_1integerTotal 1v1 clutches won
games_countintegerTotal maps/games used for calculation