Communities, ranked

GET/v1/communities

The groups running several servers, found by the website in their servers’ names or set up by their owners, ranked by real players over 7 days. Matchmaking platforms are listed apart with platforms=true.

Query parameters

qstring

Part of its name or website

platformsboolean

List matchmaking platforms instead

gamestring

A game's slug from /v1/games, or its Steam app id

pageinteger

The page, from 1 Default 1.

per_pageinteger

How many on a page Default 25.

Response

200 A page of communities. The answer is { "data": … }, with meta and links for the pages; data is Community[].

Community

slugstring

namestring

domainstring | null

claimedboolean

platformboolean

A matchmaking platform (a server per match), not ranked

rankinteger | null

players_nowinteger

average_players_7dnumber | null

serversinteger

servers_onlineinteger

flagged_serversinteger

Fake servers using its name, not counted

gamesGameRef[]

countriesstring[]

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

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

require "net/http" require "json" uri = URI("https://api.lobbyverse.com/v1/communities?per_page=2") 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": [ { "slug": "cybershoke.net", "name": "cybershoke.net", "domain": "cybershoke.net", "claimed": false, "platform": false, "rank": 1, "players_now": 7952, "average_players_7d": 4573.8, "servers": 3273, "servers_online": 3123, "flagged_servers": 87, "games": [ { "app_id": 730, "slug": "counter-strike-2", "name": "Counter-Strike 2" } ], "countries": [ "RU", "KZ" ], "links": { "self": "/v1/communities/cybershoke.net", "web": "https://lobbyverse.com/communities/cybershoke.net" } }, { "slug": "xplay.gg", "name": "xplay.gg", "domain": "xplay.gg", "claimed": false, "platform": false, "rank": 2, "players_now": 2759, "average_players_7d": 2914.5, "servers": 3321, "servers_online": 1963, "flagged_servers": 150, "games": [ { "app_id": 730, "slug": "counter-strike-2", "name": "Counter-Strike 2" } ], "countries": [ "HK", "RU" ], "links": { "self": "/v1/communities/xplay.gg", "web": "https://lobbyverse.com/communities/xplay.gg" } } ], "meta": { "page": 1, "per_page": 2, "total": 420, "total_pages": 210 }, "links": { "self": "https://api.lobbyverse.com/v1/communities?page=1&per_page=2", "first": "https://api.lobbyverse.com/v1/communities?page=1&per_page=2", "last": "https://api.lobbyverse.com/v1/communities?page=210&per_page=2", "next": "https://api.lobbyverse.com/v1/communities?page=2&per_page=2" } }