Developers / API

{
  "updated_at": 1784060000000,
  "players": 412, "bots_excluded": 893,
  "servers_populated": 78, "servers_total": 2450,
  "games_populated": 6, "games_tracked": 10, "streams_live": 18,
  "busiest_game": { "game": "ql", "players": 203 },
  "busiest_server": { "id": "ql:…", "name": "IZI PUB#1 - CLAN ARENA", "players": 24, "bots": 0 },
  "top_map": { "map": "thunderstruck", "game": "ql", "players": 27, "servers": 2 },
  /* Quake Champions' Steam concurrent count - never folded into players above */
  "qc_steam_players": 214
}

{
  "games": [
    { "id": "ql", "name": "Quake Live", "players": 203,
      "servers_populated": 44, "servers_total": 861, "updated_at": 1784060000000 },
    { "id": "q3", "name": "Quake III Arena", "players": 87,
      "servers_populated": 23, "servers_total": 480, "updated_at": 1784060000000 }
  ]
}

{
  "game": "q3", "updated_at": 1784060000000, "count": 2,
  "servers": [ /* the server object shown under /server/{game}/{ip}/{port} */ ]
}

{
  "id": "q3:45.13.1.2:27960", "game": "q3", "game_name": "Quake III Arena",
  "name": "pro-q3tourney2 · TDM", "map": "q3tourney2", "gametype": "TDM",
  "players": 6, "bots": 1, "max_players": 16, "ping_ms": 41,
  "region": "Europe", "country": "DE", "ll": [50.1, 8.6],
  "connect": { "address": "45.13.1.2:27960", "url": null, "command": "connect 45.13.1.2:27960" },
  "match": { "state": null, "red_score": 7, "blue_score": 6, "round_limit": 10, "clock": "3:12" },
  "roster": [
    { "name": "Bim", "kind": "player", "score": 24, "ping_ms": 68, "time_s": 1260, "time_observed": true },
    { "name": "UnnamedPlayer", "kind": "player", "score": 1, "ping_ms": 41, "time_s": 180, "time_observed": true }
  ]
}

{
  "query": "rapha", "count": 1,
  "results": [
    { "player": "rapha", "kind": "player", "game": "ql", "game_name": "Quake Live",
      "server": "IZI PUB#1 - CLAN ARENA", "server_id": "ql:54.37.93.142:27961",
      "address": "54.37.93.142:27961", "score": 42, "ping_ms": 38 }
  ]
}

{
  "query": "retro", "count": 2,
  "results": [
    { "id": "q3:216.114.75.24:27960", "name": "RETRO FFA", "game": "q3",
      "game_name": "Quake III Arena", "address": "216.114.75.24:27960",
      "map": "q3dm17", "players": 11, "bots": 3, "max_players": 20 }
  ]
}

{
  "updated_at": 1784060000000, "count": 78,
  "servers": [ /* every populated server, busiest first - same shape as /servers/{game} */ ]
}

{
  "type": "FeatureCollection",
  "updated_at": 1784060000000, "count": 63, "players": 402,
  "features": [
    { "type": "Feature",
      /* [longitude, latitude] - GeoJSON order, the REVERSE of the ll field elsewhere */
      "geometry": { "type": "Point", "coordinates": [8.6, 50.1] },
      "properties": { "id": "q3:45.13.1.2:27960", "game": "q3", "game_name": "Quake III Arena",
        "name": "! UnFreeZe.fpsclasico.de", "players": 14, "map": "q3wcp9", "country": "DE" } }
  ]
}

{
  "updated_at": 1784060000000, "players": 402,
  "count": 34, "countries_populated": 19,
  "countries": [
    /* countries are the SERVERS' locations - we never know where a player is sitting */
    { "country": "DE", "players": 118, "servers": 412, "servers_populated": 22,
      "games": { "q3": 61, "ql": 38, "cpma": 19 } },
    { "country": "US", "players": 96, "servers": 780, "servers_populated": 18,
      "games": { "q2": 41, "nq": 33, "qe": 22 } }
  ]
}

{
  "game": "all", "updated_at": 1784060000000, "count": 3,
  "maps": [
    { "map": "thunderstruck", "game": "ql", "game_name": "Quake Live", "players": 27, "servers": 2 },
    { "map": "bloodrun",      "game": "ql", "game_name": "Quake Live", "players": 25, "servers": 3 },
    { "map": "q3dm17",        "game": "q3", "game_name": "Quake III Arena", "players": 9, "servers": 1 }
  ]
}

{
  "game": "q3", "map": "pro-q3dm6", "count": 18, "players": 13,
  "servers": [ { "name": "...", "players": 6, "map": "pro-q3dm6", "connect": { "command": "connect 1.2.3.4:27960" } } ]
}

{
  /* A server that does not answer is a RESULT, not an error: you get 200 with online:false,
     because "no reply" is exactly what you came to find out. */
  "online": true,
  "queried_at": 1784060000000,
  "game": "q2",
  "server": {
    "name": "QuakeHub.net FFA", "map": "q2dm1", "players": 3, "max_players": 16,
    "connect": { "command": "connect 149.28.241.196:27910" }
  }
}

{
  "server": { "id": "q3:1.2.3.4:27960", "name": "Evening Server", "game": "q3" },
  "timezone": "UTC",
  /* false until we have seen 8+ hours of the day AND the server has ever been populated.
     While it is false, treat the numbers below as "not known yet", not as a finding. */
  "enough_data": true,
  "hours_covered": 24, "samples": 2016,
  "busiest_hour_utc": 19, "busiest_hour_avg": 16,
  "hourly": [0.2, 0.1, "… 24 values, one per UTC hour …"]
}

{
  "game": "q3",
  "window": { "from": 1784000000000, "to": 1784086400000, "hours": 25 },
  "window_complete": true,
  "count": 2,
  "servers": [
    { "id": "q3:198.51.100.7:27960", "name": "EU Pickup", "game": "q3", "peak": 12,
      "hours": [0,0,0,0,0,0,0,0,0,0,2,6,12,9,4,0,0,0,0,0,0,0,3,5,1] },
    { "id": "q3:203.0.113.9:27960", "name": "2am Duels", "game": "q3", "peak": 2,
      "hours": [0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0] }
  ]
}

{
  "game": "q3", "window": "7 days", "count": 3,
  "rows": [
    /* weight = player-time over the week, so twenty EMPTY cpma servers cannot outrank one full one */
    { "name": "baseq3", "weight": 11675, "share": 36 },
    { "name": "osp", "weight": 7508, "share": 23 },
    { "name": "unfreeze", "weight": 6903, "share": 21 }
  ]
}

{
  "game": "q3", "window": "7 days", "count": 3,
  "rows": [
    { "name": "FFA", "weight": 14833, "share": 46 },
    { "name": "TDM", "weight": 9658, "share": 30 },
    { "name": "CTF", "weight": 5220, "share": 16 }
  ]
}

{
  "count": 3, "online": 2, "players": 7,
  "servers": [
    { "id": "q2:149.28.241.196:27910", "name": "QuakeHub.net Deathmatch - Dallas",
      "game": "q2", "map": "q2dm1", "players": 5, "max_players": 16, "online": true,
      "connect": { "command": "connect 149.28.241.196:27910" } },
    { "id": "nq:149.28.241.196:26000", "name": "QuakeHub.net Deathmatch - Dallas",
      "game": "nq", "map": "dm3", "players": 2, "max_players": 16, "online": true },
    /* Still here, still in your order - a list that quietly drops a row is worse than one
       that says the box is down. */
    { "id": "q4:5.6.7.8:28004", "name": "5.6.7.8:28004", "game": "q4",
      "online": false, "players": 0, "max_players": null }
  ]
}

{
  "game": "all", "region": null, "min_players": 1, "candidates": 47,
  /* the fullest server right now. server is null (with a 200) when nobody is playing. */
  "server": { "name": "tastyspleen.net::dm", "game": "q2", "players": 11, "map": "q2dm1",
    "connect": { "address": "216.246.62.51:27910", "command": "connect 216.246.62.51:27910" } }
}

{
  "game": "all", "candidates": 47,
  "server": { "name": "...", "players": 3, "connect": { "command": "connect 1.2.3.4:27960" } }
}

{
  "game": "q3",
  "day": [ { "t": 1784056400000, "p": 84 }, { "t": 1784056490000, "p": 87 } ],
  "hourly": [ 12.4, 9.1, 6.0, 4.2, "… 24 values, one per UTC hour …" ],
  "hours_covered": 24
}

$ curl -N https://quakehub.net/api/v1/stream

event: hello
data: {"note":"Live snapshot updates...","keepalive_seconds":20,
       "games":[{"game":"ql","players":151,"servers_populated":38,"servers_total":865}, ...]}

event: update
data: {"game":"q3","updated_at":1784060000000,"players":48,"bots_excluded":312,
       "servers_total":461,"servers_populated":14}

: keepalive

// In a browser, no library needed:
const es = new EventSource('https://quakehub.net/api/v1/stream');
es.addEventListener('update', (e) => {
  const g = JSON.parse(e.data);
  console.log(g.game + ': ' + g.players + ' playing');
});

{
  "game": "q3", "game_name": "Quake III Arena",
  "days_held": 92, "count": 92,
  "series": [
    /* peak = busiest single poll that day, avg = mean across the day, servers = most seen */
    { "day": "2026-04-27", "peak": 118, "avg": 61, "servers": 474 },
    { "day": "2026-04-28", "peak": 132, "avg": 66, "servers": 479 },
    "… one row per day …"
  ]
}

{
  "month": "2026-08", "in_progress": true,
  "scene_peak": { "players": 511, "at": 1785900000000 },
  "matches": 4812, "human_hours": 9400,
  "servers_populated": 214, "servers_first_seen": 12, "servers_gone": null,
  "distinct_maps": 312, "distinct_countries": 41, "fakes_per_poll": 1604,
  /* the SERVERS' countries, weighted by the humans playing on them - the month's hosting map */
  "countries": [ { "name": "DE", "share": 31 }, { "name": "US", "share": 27 } ],
  "gametypes": [ { "name": "Clan Arena", "share": 34 }, { "name": "Duel", "share": 21 } ],
  "mods": [ { "name": "cpma", "share": 41 }, { "name": "osp", "share": 22 } ],
  /* the month's 24-hour shape (avg humans per UTC hour) and its daily population line */
  "hours": [ 118, 96, "… 24 values …" ],
  "daily": [ { "day": "2026-08-01", "players": 88 }, "… one per day …" ],
  "games": [
    { "game": "q3", "game_name": "Quake III Arena", "matches": 1904,
      "map_of_the_month": { "name": "q3dm17", "share": 22 },
      "fullest_match": { "players": 24, "server": "GENESIS CTF" },
      "countries": [ { "name": "DE", "share": 44 } ],
      "fakes_excluded": { "avg_per_poll": 78.5, "worst_poll": 141 } }
  ],
  "top_servers": [ { "name": "! UnFreeZe.fpsclasico.de", "game": "q3", "hours": 2260, "avg_players": 14.2, "peak": 22, "days_populated": 29 } ],
  "top_maps": [ { "name": "q3dm17", "game": "q3", "game_name": "Quake III Arena", "share": 6.2 } ],
  "matchmaking": [ { "game": "qc", "game_name": "Quake Champions", "peak": 254, "avg": 187 } ],
  "streams": { "peak_live_streams": 21, "peak_viewers": 1044,
    "top_stream": { "name": "ZooLDTV", "peak_viewers": 640 } }
}

{
  "game": "q2", "game_name": "Quake II",
  "days_observed": 7, "map_days_observed": 7,
  "peak": { "players": 82, "at": 1784060000000 },
  "busiest_day_utc": 0, "busiest_day_avg": 48.2,
  "busiest_hour_utc": 19, "busiest_hour_avg": 71,
  "occupied_share": 100,
  "maps":  [ { "name": "q2dm1", "players": 812, "share": 24 } ],
  "modes": [ { "name": "DM", "players": 1907, "share": 56 } ],
  /* Action Quake beats vanilla in Quake II - the kind of thing only a week of data shows */
  "mods":  [ { "name": "action", "players": 1955, "share": 58 } ],
  /* the SERVERS' countries, from a geo lookup on their IPs - not where the players are */
  "countries": [ { "name": "US", "players": 3012, "share": 89 } ],
  "fullest_match": { "players": 12, "server": "tastyspleen.net::dm", "map": "q2dm3", "at": 1784060000000 },
  "top_servers": [
    { "id": "q2:1.2.3.4:27910", "name": "tastyspleen.net::dm", "address": "1.2.3.4:27910", "avg_players": 4.9, "players": 6 }
  ],
  "servers_tracked": 428, "servers_populated": 12
}

GET /api/v1/card/week/q2
Content-Type: image/svg+xml

{
  "checked_at": 1784060000000, "count": 18, "alive": 15, "dead": 1,
  "masters": [
    /* the only master stock Quake III asks. It answers - with a fraction of the list a
       source port sees, which is the actual reason to install one. */
    { "game": "q3", "game_name": "Quake III Arena", "host": "master.quake3arena.com", "port": 27950,
      "alive": true, "servers": 99, "ms": 41, "error": null },
    { "game": "q3", "game_name": "Quake III Arena", "host": "master.ioquake3.org", "port": 27950,
      "alive": true, "servers": 891, "ms": 210, "error": null },
    /* Quake 4's masters really are gone; this one is ours (quakehub-q4master). */
    { "game": "q4", "game_name": "Quake 4", "host": "master.quakehub.net", "port": 27650,
      "alive": true, "servers": 19, "ms": 465, "error": null },
    /* alive:null = we do not speak this master's protocol. Unknown, not dead. */
    { "game": "qe", "game_name": "Quake (Enhanced)", "host": "dpmaster.deathmask.net", "port": 27950,
      "alive": null, "servers": null, "error": "protocol_not_queryable" }
  ]
}

{
  "updated_at": 1784060000000, "count": 1,
  "streams": [
    { "user": "zooldtv", "name": "ZooLDTV", "title": "Quake Live duels all night",
      "viewers": 210, "game": "Quake Live", "language": "en",
      "url": "https://twitch.tv/zooldtv", "thumbnail": "https://…-440x248.jpg" }
  ]
}

{
  "updated_at": 1784060000000, "count": 1,
  "events": [
    { "game": "ql", "name": "250 FPS QL League - Season 6", "starts": "2026-09-12",
      "ends": null, "prize": null, "tier": null,
      "link": "https://www.plusforward.net/quake/events/", "source": "plusforward",
      /* the backend's pin decision - true when the title, venue or a BYOC marker says QuakeCon */
      "quakecon": false }
  ]
}

GET /api/v1/badge/q3
Content-Type: image/svg+xml

GET /api/v1/badge/server/ql/45.125.247.117/27960
Content-Type: image/svg+xml

GET /api/v1/badge/streams
Content-Type: image/svg+xml

GET /api/v1/card/server/ql/45.125.247.117/27960
Content-Type: image/svg+xml

GET /api/v1/card/busy/ql/45.125.247.117/27960
Content-Type: image/svg+xml

GET /api/v1/card/scene
Content-Type: image/svg+xml

GET /api/v1/card/trend/q3
Content-Type: image/svg+xml

GET /api/v1/card/top?limit=3
Content-Type: image/svg+xml

GET /api/v1/card/top/q2?limit=3
Content-Type: image/svg+xml

GET /api/v1/card/list?label=Our%20Servers&servers=q2:149.28.241.196:27910,nq:149.28.241.196:26000,q4:149.28.241.196:28004,bloodrun:149.28.241.196:27960,cpma:149.28.241.196:27962,qcde:149.28.241.196:10666
Content-Type: image/svg+xml