Your first request

With your key at hand, three calls cover most uses.

Find servers

The busiest listed Counter-Strike 2 surf servers in Germany:

curl "https://api.lobbyverse.com/v1/servers?game=counter-strike-2&mode=surf&country=DE&per_page=5" \
  -H "Authorization: Bearer lv_YOUR_KEY"

{
  "data": [
    {
      "address": "203.0.113.10:27015",
      "name": "Surf Heaven #1",
      "game": { "app_id": 730, "slug": "counter-strike-2", "name": "Counter-Strike 2" },
      "map": "surf_ski_2",
      "mode": "surf",
      "players": 18,
      "bots": 0,
      "max_players": 32,
      "online": true,
      "status": "listed",
      "country": "DE",
      "tags": ["public"],
      "language": null,
      "password": false,
      "vac": true,
      "connect_url": "steam://connect/203.0.113.10:27015",
      "last_checked_at": "2026-11-02T01:40:12Z",
      "links": { "self": "/v1/servers/203.0.113.10:27015", "web": "https://lobbyverse.com/servers/203.0.113.10:27015" }
    }
  ],
  "meta": { "page": 1, "per_page": 5, "total": 41, "total_pages": 9 },
  "links": { "next": "https://api.lobbyverse.com/v1/servers?…&page=2" }
}

players are real players: bots are counted apart, and servers flagged as fake aren’t listed unless you ask for them.

Look one up

curl "https://api.lobbyverse.com/v1/servers/203.0.113.10:27015" -H "Authorization: Bearer lv_YOUR_KEY"

The server with its plugins, location, community and links to its players, settings and history.

Pick one to join

curl "https://api.lobbyverse.com/v1/quickplay?game=counter-strike&mode=warcraft-3&near=40.71,-74.00" \
  -H "Authorization: Bearer lv_YOUR_KEY"

The busiest server with a free slot and no password, ones with players before empty ones, nearest first. Open its connect_url to join.