A game's top servers

GET/v1/leaderboards/{game}

A game’s top servers by average real players over the last 7 days, offline hours counting as empty. Fakes aren’t ranked.

Path parameters

gamestring · required

Its slug or Steam app id

Query parameters

per_pageinteger

How many on a page Default 25.

Response

200 The top servers. The answer is { "data": … }; data is Ranked[].

Ranked

rankinteger

average_players_7dnumber

serverServer

Server

addressstring

ip:port

namestring | null

gameGameRef

mapstring | null

modestring | null

Its game mode

bomb-defusalhostage-rescuearenasurfclimbzombies+18

playersinteger

Real players now; bots are counted apart

botsinteger

max_playersinteger

onlineboolean

statusstring

listed: checked and real. flagged: its numbers look fake, see flagged_reasons

listedpendingflagged

countrystring | null

tagsstring[]

What it offers, read from its name

free_vipvippublicclassicdeathmatchrespawn+12

languagestring | null

The language its name says it's in

passwordboolean

vacboolean

connect_urlstring

steam://connect/ip:port, to join

last_checked_atstring | null

linksobject

GameRef

app_idinteger

slugstring

namestring

Errors

Errors are problem details with a detail written to be shown to people.

Status	When
`400`	A parameter isn’t valid
`401`	No API key, or one that isn’t valid or was revoked
`429`	Over a rate limit (60 a minute, 10000 a day per key); see Retry-After
`503`	History or rankings are briefly unavailable

const response = await fetch("https://api.lobbyverse.com/v1/leaderboards/counter-strike-2?per_page=3", { headers: { Authorization: `Bearer ${process.env.LOBBYVERSE_KEY}` }, }); const { data } = await response.json();

import os, requests response = requests.get( "https://api.lobbyverse.com/v1/leaderboards/counter-strike-2?per_page=3", headers={"Authorization": f"Bearer {os.environ['LOBBYVERSE_KEY']}"}, ) data = response.json()["data"]

require "net/http" require "json" uri = URI("https://api.lobbyverse.com/v1/leaderboards/counter-strike-2?per_page=3") request = Net::HTTP::Get.new(uri, "Authorization" => "Bearer #{ENV.fetch("LOBBYVERSE_KEY")}") response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { it.request(request) } data = JSON.parse(response.body)["data"]

{ "data": [ { "rank": 1, "average_players_7d": 21.7, "server": { "address": "95.170.111.207:40066", "name": "➥███ FB-CS.RU | DUST2 #2 СПБ | СКИНЫ ВСЕМ !drop", "game": { "app_id": 730, "slug": "counter-strike-2", "name": "Counter-Strike 2" }, "map": "de_dust2", "mode": "bomb-defusal", "players": 63, "bots": 0, "max_players": 64, "online": true, "status": "listed", "country": "RU", "tags": [ "skins" ], "language": null, "password": false, "vac": true, "connect_url": "steam://connect/95.170.111.207:40066", "last_checked_at": "2026-11-02T13:16:12Z", "links": { "self": "/v1/servers/95.170.111.207:40066", "web": "https://lobbyverse.com/servers/95.170.111.207:40066" } } }, { "rank": 2, "average_players_7d": 21.2, "server": { "address": "168.100.163.167:27015", "name": "[FN] 24/7 Surf Utopia [Styles] discord.gg/fallen", "game": { "app_id": 730, "slug": "counter-strike-2", "name": "Counter-Strike 2" }, "map": "surf_utopia_njv", "mode": "surf", "players": 11, "bots": 1, "max_players": 64, "online": true, "status": "listed", "country": "US", "tags": [], "language": null, "password": false, "vac": true, "connect_url": "steam://connect/168.100.163.167:27015", "last_checked_at": "2026-11-02T13:18:43Z", "links": { "self": "/v1/servers/168.100.163.167:27015", "web": "https://lobbyverse.com/servers/168.100.163.167:27015" } } } ], "meta": { "game": { "app_id": 730, "slug": "counter-strike-2", "name": "Counter-Strike 2" }, "ranked": 10820 } }