API
Données en direct des serveurs communautaires de chaque jeu de srcdslist, au format JSON, mises à jour toutes les 5 minutes.
Vous venez de teamwork.tf ?
Les chemins et les champs correspondent à l'API v1 de teamwork.tf. Remplacez teamwork.tf par srcdslist.com et votre outil devrait continuer à fonctionner. Votre ancienne clé ne marche pas ici ; les requêtes sans clé fonctionnent aussi (voir les limites), ou créez une clé sur la page de votre compte.
Jeux
Chaque endpoint répond pour TF2, sauf si vous ajoutez ?game=l4d2 ou ?game=cs2 (par exemple /api/v1/stats?game=cs2). Les listes de serveurs, les actualités et les pages de cartes suivent la même règle.
Les autres jeux : ?game=gmod (Garry's Mod), ?game=l4d (Left 4 Dead) et ?game=css (Counter-Strike: Source).
Limites et clés
- Sans clé : 30 requêtes par minute par adresse IP. Avec
?key=YOUR_KEY: 90 par minute. - Au-delà de la limite, vous recevez HTTP 429 et
{"error": "RATE_LIMITED"}jusqu'à la fin de la minute. - Les erreurs ont toujours la forme
{"error": "ERROR_CODE"}.
Endpoints
| Chemin | Renvoie |
|---|---|
/api/v1/quickplay | Les modes de jeu, répartis en gamemodes_official et gamemodes_community, chacun avec id, title, desc, color, playing. |
/api/v1/quickplay/{gamemode} | Un mode de jeu avec playing. |
/api/v1/quickplay/{gamemode}/servers | Les serveurs de ce mode (tableau). |
/api/v1/quickplay/server?ip=IP&port=PORT | Un serveur, ou tous les serveurs de l'IP si port est omis. Toujours un tableau. |
/api/v1/community/provider/{slug} | Une communauté : nom, description, site, règlement, groupe Steam, Discord, région principale. |
/api/v1/community/provider/{slug}/stats | Ses joueurs, ses joueurs par région, ses modes, ses serveurs en ligne et au total. |
/api/v1/community/provider/{slug}/servers | Ses serveurs en ligne (tableau). Filtres facultatifs : gamemode (le slug d'un mode, ou _unknown), region (ex. Europe), hide_full=1, hide_password=1, hide_empty=1. |
/api/v1/map-stats/search?search_term=TEXT | Jusqu'à 50 noms de cartes contenant le texte. |
/api/v1/map-stats/map/{map} | Première et dernière apparition, record de joueurs et de serveurs simultanés, moyenne de joueurs, officielle ou non, versions liées, modes de jeu. |
/api/v1/customserverlist | Les listes de serveurs créées par les joueurs : nom, description, créateur, abonnés, filtres (filter_hostname_whitelist, filter_hostname_blacklist comme sur teamwork.tf, plus modes, régions, préfixes de cartes, tags). |
/api/v1/customserverlist/{id} et /{id}/servers | Une liste, et les serveurs qu'elle contient maintenant. |
/api/v1/competitive/provider/{provider} et /stats | Un site de lobbys ou une ligue ; pour les sites de lobbys que nous reconnaissons, les joueurs actuels et les serveurs occupés ou vides. |
/api/v1/news (?source=) | Les titres d'actualité du jeu : titre, lien, source, date de publication. |
/api/v1/stats | Totaux : joueurs, serveurs avec joueurs, joueurs par région et par mode, faux joueurs et inactifs écartés, le décompte de Steam pour le jeu. |
Champs d'un serveur
ip, port (chaîne), name, reachable, provider (slug de la communauté ou null), valve_secure, map_name, map_name_next, players, max_players, gamemodes, gametype (les tags du serveur), has_password, has_rtd, has_randomcrits, has_norespawntime, has_alltalk. Ajoutés par srcdslist : humans, bots, region, trust, steam_relay, official (géré par Valve : les serveurs officiels de L4D2).
Différences avec teamwork.tf
playerscorrespond aux vraies personnes en jeu : les bots, les faux nombres de joueurs et les comptes inactifs sont exclus. Dans/api/v1/stats,playingetregionssont les vraies personnes actives sur les serveurs que nous listons (serveurs communautaires, plus les serveurs officiels de Valve pour L4D2 :community_playersetofficial_playersles séparent) ;trading_playersen est la part sur les serveurs d'échange et de succès de TF2, etidle_map_playerscorrespond aux personnes sur des cartes idle, qui ne font pas partie deplaying(chaque serveur et chaque mode indiquent toujours leurs propres joueurs).humans, c'est tous ceux qui ne sont pas des bots.map_name_nextest toujours vide : les serveurs n'indiquent pas leur prochaine carte aux requêtes.- Les valeurs
colordes modes sont les nôtres. - Le
thumbnaild'une carte est un lien vers notre copie de son image, ou null s'il n'y en a pas ;extra_infoetcontextsont null pour l'instant. L'historique commence le 6 novembre 2026 pour TF2 et le 8 novembre 2026 pour L4D2 et CS2.