API
Live community server data for every game on srcdslist as JSON, updated every 5 minutes.
Coming from teamwork.tf?
The paths and fields match teamwork.tf's API v1. Change teamwork.tf to srcdslist.com and your tool should keep working. Your old key won't work here; requests without a key work too (see limits), or create a key on your account page.
Games
Every endpoint answers for TF2 unless you add ?game=l4d2 or ?game=cs2 (for example /api/v1/stats?game=cs2). Server lists, news and map pages follow the same rule.
The other games: ?game=gmod (Garry's Mod), ?game=l4d (Left 4 Dead) and ?game=css (Counter-Strike: Source).
Limits and keys
- Without a key: 30 requests a minute per IP address. With
?key=YOUR_KEY: 90 a minute. - Over the limit you get HTTP 429 and
{"error": "RATE_LIMITED"}until the minute is up. - Errors always look like
{"error": "ERROR_CODE"}.
Endpoints
| Path | Returns |
|---|---|
/api/v1/quickplay | Gamemodes, split into gamemodes_official and gamemodes_community, each with id, title, desc, color, playing. |
/api/v1/quickplay/{gamemode} | One gamemode with playing. |
/api/v1/quickplay/{gamemode}/servers | Servers in that mode (array). |
/api/v1/quickplay/server?ip=IP&port=PORT | One server, or every server on the IP if port is left out. Always an array. |
/api/v1/community/provider/{slug} | A community: name, description, website, rules, Steam group, Discord, location focus. |
/api/v1/community/provider/{slug}/stats | Its players, players by region, gamemodes, servers online and total. |
/api/v1/community/provider/{slug}/servers | Its servers that are online (array). Optional filters: gamemode (a mode's slug, or _unknown), region (e.g. Europe), hide_full=1, hide_password=1, hide_empty=1. |
/api/v1/map-stats/search?search_term=TEXT | Up to 50 map names containing the text. |
/api/v1/map-stats/map/{map} | First and last seen, most players and servers at once, average players, official or not, related versions, gamemodes. |
/api/v1/customserverlist | Server lists people made: name, description, creator, subscribers, filters (filter_hostname_whitelist, filter_hostname_blacklist as on teamwork.tf, plus gamemodes, regions, map prefixes, tags). |
/api/v1/customserverlist/{id} and /{id}/servers | One list, and the servers in it now. |
/api/v1/competitive/provider/{provider} and /stats | A lobby site or league; for lobby sites we can recognise, players now and servers in use or empty. |
/api/v1/news (?source=) | News headlines for the game: title, link, source, published. |
/api/v1/stats | Totals: players, servers with players, players by region and mode, fake and idle players left out, Steam's own count for the game. |
Server fields
ip, port (string), name, reachable, provider (community slug or null), valve_secure, map_name, map_name_next, players, max_players, gamemodes, gametype (the server's tags), has_password, has_rtd, has_randomcrits, has_norespawntime, has_alltalk. Added by srcdslist: humans, bots, region, trust, steam_relay, official (run by Valve: L4D2's official servers).
Differences from teamwork.tf
playersis real people playing: bots, fake player counts and idling accounts are left out. In/api/v1/stats,playingandregionsare real, active people on the servers we list (community servers, plus Valve's official L4D2 servers:community_playersandofficial_playerssplit them);trading_playersis the part of them on TF2's trading and achievement servers, andidle_map_playersis the people on idle maps, who are not part ofplaying(each server and mode still reports its own people).humansis everyone who isn't a bot.map_name_nextis always empty: servers don't report their next map to queries.- Gamemode
colorvalues are our own. - Map
thumbnailis a link to our copy of the map's picture, or null when there is none;extra_infoandcontextare null for now. History starts 6 November 2026 for TF2 and 8 November 2026 for L4D2 and CS2.