Rankings

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

API Endpoint

GET/v6/esports/{discipline}/rankings

Parameters

Parameter	Type	Required	Description
discipline	string	✓	Game slug: `cs2`, `valorant`, `lol`, `dota-2`
sort_by	string	—	Sort field: `rating`, `kills`, `kd_ratio`
timeframe	string	—	Time range: `30d`, `90d`, `year`
limit	integer	—	Max 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

Field	Type	Description
avg_player_rating	float	HLTV-style rating (6.5+ is elite)
avg_kd_rate	float	Average Kill/Death ratio
avg_headshot_kills_accuracy	float	Percentage of kills that were headshots
multikills_vs_5	integer	Total number of Aces (5K) recorded
clutches_vs_1	integer	Total 1v1 clutches won
games_count	integer	Total maps/games used for calculation

← Matches Next: Players →