API
srcdslist 每款遊戲的社群伺服器即時資料(JSON 格式),每 5 分鐘更新。
從 teamwork.tf 過來的嗎?
路徑與欄位和 teamwork.tf 的 API v1 相同。把 teamwork.tf 換成 srcdslist.com,你的工具應該就能繼續運作。你的舊金鑰在這裡無效;不帶金鑰的請求也能用(請見限制),或在你的帳號頁面建立金鑰。
遊戲
每個端點預設回應 TF2,除非你加上 ?game=l4d2 或 ?game=cs2(例如 /api/v1/stats?game=cs2)。伺服器清單、新聞與地圖頁面也遵循同樣規則。
其他遊戲:?game=gmod(Garry's Mod)、?game=l4d(Left 4 Dead)與 ?game=css(Counter-Strike: Source)。
限制與金鑰
- 沒有金鑰:每個 IP 位址每分鐘 30 次請求。加上
?key=YOUR_KEY:每分鐘 90 次。 - 超過限制時,在這一分鐘結束前你會收到 HTTP 429 與
{"error": "RATE_LIMITED"}。 - 錯誤一律是
{"error": "ERROR_CODE"}的格式。
端點
| 路徑 | 回傳 |
|---|---|
/api/v1/quickplay | 遊戲模式,分為 gamemodes_official 與 gamemodes_community,各有 id、title、desc、color、playing。 |
/api/v1/quickplay/{gamemode} | 單一遊戲模式及其 playing。 |
/api/v1/quickplay/{gamemode}/servers | 該模式中的伺服器(陣列)。 |
/api/v1/quickplay/server?ip=IP&port=PORT | 一台伺服器;如果省略 port,則是該 IP 上的所有伺服器。一律是陣列。 |
/api/v1/community/provider/{slug} | 一個社群:名稱、描述、網站、規則、Steam 群組、Discord、主要地區。 |
/api/v1/community/provider/{slug}/stats | 它的玩家數、各地區玩家數、遊戲模式、在線與全部伺服器數。 |
/api/v1/community/provider/{slug}/servers | 它在線的伺服器(陣列)。可選篩選條件:gamemode(模式的代稱,或 _unknown)、region(例如 Europe)、hide_full=1、hide_password=1、hide_empty=1。 |
/api/v1/map-stats/search?search_term=TEXT | 最多 50 個包含該文字的地圖名稱。 |
/api/v1/map-stats/map/{map} | 首次與最後一次出現時間、同時最多玩家與伺服器數、平均玩家數、是否官方、相關版本、遊戲模式。 |
/api/v1/customserverlist | 玩家建立的伺服器清單:名稱、描述、建立者、訂閱數、篩選條件(filter_hostname_whitelist、filter_hostname_blacklist 與 teamwork.tf 相同,另加遊戲模式、地區、地圖前綴、標籤)。 |
/api/v1/customserverlist/{id} 與 /{id}/servers | 一個清單,以及目前在其中的伺服器。 |
/api/v1/competitive/provider/{provider} 與 /stats | 大廳網站或聯賽;對於我們能辨認的大廳網站,會顯示目前玩家數,以及使用中或空著的伺服器。 |
/api/v1/news (?source=) | 這款遊戲的新聞標題:標題、連結、來源、發布時間。 |
/api/v1/stats | 總計:玩家數、有玩家的伺服器、各地區與各模式玩家數、被排除的偽造與掛機玩家、Steam 自己對這款遊戲的統計。 |
伺服器欄位
ip、port(字串)、name、reachable、provider(社群代稱或 null)、valve_secure、map_name、map_name_next、players、max_players、gamemodes、gametype(伺服器的標籤)、has_password、has_rtd、has_randomcrits、has_norespawntime、has_alltalk。srcdslist 另外加上:humans、bots、region、trust、steam_relay、official(由 Valve 營運:L4D2 的官方伺服器)。
與 teamwork.tf 的差異
players是真正在玩的人:機器人、偽造的玩家數與掛機帳號都被排除。在/api/v1/stats中,playing與regions是我們列出的伺服器上真實、活躍的人(社群伺服器,加上 Valve 的 L4D2 官方伺服器:community_players與official_players分開計算);trading_players是其中在 TF2 交易與成就伺服器上的部分,idle_map_players是在掛機地圖上的人,他們不屬於playing(每台伺服器與每個模式仍會回報自己的人數)。humans是所有不是機器人的人。map_name_next永遠是空的:伺服器不會在查詢中回報下一張地圖。- 遊戲模式的
color值是我們自己訂的。 - 地圖的
thumbnail是我們保存的地圖圖片副本連結,沒有圖片時為 null;extra_info與context目前為 null。歷史資料 TF2 從 2026 年 11 月 6 日開始,L4D2 與 CS2 從 2026 年 11 月 8 日開始。