API
Datos en directo de los servidores comunitarios de cada juego de srcdslist en JSON, actualizados cada 5 minutos.
¿Vienes de teamwork.tf?
Las rutas y los campos coinciden con la API v1 de teamwork.tf. Cambia teamwork.tf por srcdslist.com y tu herramienta debería seguir funcionando. Tu clave antigua no sirve aquí; las solicitudes sin clave también funcionan (mira los límites), o crea una clave en la página de tu cuenta.
Juegos
Todos los endpoints responden para TF2 salvo que añadas ?game=l4d2 o ?game=cs2 (por ejemplo /api/v1/stats?game=cs2). Las listas de servidores, las noticias y las páginas de mapas siguen la misma regla.
Los otros juegos: ?game=gmod (Garry's Mod), ?game=l4d (Left 4 Dead) y ?game=css (Counter-Strike: Source).
Límites y claves
- Sin clave: 30 solicitudes por minuto por dirección IP. Con
?key=YOUR_KEY: 90 por minuto. - Si te pasas del límite recibes HTTP 429 y
{"error": "RATE_LIMITED"}hasta que acabe el minuto. - Los errores siempre tienen la forma
{"error": "ERROR_CODE"}.
Endpoints
| Ruta | Devuelve |
|---|---|
/api/v1/quickplay | Modos de juego, divididos en gamemodes_official y gamemodes_community, cada uno con id, title, desc, color, playing. |
/api/v1/quickplay/{gamemode} | Un modo de juego con playing. |
/api/v1/quickplay/{gamemode}/servers | Servidores de ese modo (array). |
/api/v1/quickplay/server?ip=IP&port=PORT | Un servidor, o todos los servidores de la IP si se omite port. Siempre un array. |
/api/v1/community/provider/{slug} | Una comunidad: nombre, descripción, web, normas, grupo de Steam, Discord, región principal. |
/api/v1/community/provider/{slug}/stats | Sus jugadores, jugadores por región, modos de juego, servidores en línea y totales. |
/api/v1/community/provider/{slug}/servers | Sus servidores en línea (array). Filtros opcionales: gamemode (el slug de un modo, o _unknown), region (p. ej. Europe), hide_full=1, hide_password=1, hide_empty=1. |
/api/v1/map-stats/search?search_term=TEXT | Hasta 50 nombres de mapa que contengan el texto. |
/api/v1/map-stats/map/{map} | Primera y última vez visto, máximo de jugadores y servidores a la vez, media de jugadores, si es oficial, versiones relacionadas, modos de juego. |
/api/v1/customserverlist | Listas de servidores creadas por la gente: nombre, descripción, creador, suscriptores, filtros (filter_hostname_whitelist, filter_hostname_blacklist como en teamwork.tf, más modos, regiones, prefijos de mapa, etiquetas). |
/api/v1/customserverlist/{id} y /{id}/servers | Una lista, y los servidores que tiene ahora. |
/api/v1/competitive/provider/{provider} y /stats | Una web de salas o una liga; para las webs de salas que reconocemos, jugadores ahora y servidores en uso o vacíos. |
/api/v1/news (?source=) | Titulares de noticias del juego: título, enlace, fuente, fecha de publicación. |
/api/v1/stats | Totales: jugadores, servidores con jugadores, jugadores por región y modo, jugadores falsos e inactivos excluidos, el recuento propio de Steam para el juego. |
Campos de servidor
ip, port (texto), name, reachable, provider (slug de la comunidad o null), valve_secure, map_name, map_name_next, players, max_players, gamemodes, gametype (las etiquetas del servidor), has_password, has_rtd, has_randomcrits, has_norespawntime, has_alltalk. Añadidos por srcdslist: humans, bots, region, trust, steam_relay, official (lo gestiona Valve: los servidores oficiales de L4D2).
Diferencias con teamwork.tf
playersson personas reales jugando: se excluyen bots, cifras de jugadores falsas y cuentas inactivas. En/api/v1/stats,playingyregionsson personas reales y activas en los servidores que listamos (servidores de la comunidad, más los servidores oficiales de Valve para L4D2:community_playersyofficial_playerslos separan);trading_playerses la parte de ellas en los servidores de intercambio y logros de TF2, eidle_map_playersson las personas en mapas idle, que no forman parte deplaying(cada servidor y modo sigue mostrando su propia gente).humanses todo el que no es un bot.map_name_nextsiempre está vacío: los servidores no informan de su siguiente mapa en las consultas.- Los valores
colorde los modos son nuestros. - El
thumbnailde un mapa es un enlace a nuestra copia de la imagen del mapa, o null si no la hay;extra_infoycontextson null por ahora. El historial empieza el 6 de noviembre de 2026 para TF2 y el 8 de noviembre de 2026 para L4D2 y CS2.