API
Данные о серверах сообщества для каждой игры на srcdslist в формате JSON, обновляются каждые 5 минут.
Переходите с teamwork.tf?
Пути и поля совпадают с API v1 teamwork.tf. Замените 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).
Ограничения и ключи
- Без ключа: 30 запросов в минуту на IP-адрес. С
?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 | Один сервер или все серверы на IP, если port не указан. Всегда массив. |
/api/v1/community/provider/{slug} | Сообщество: название, описание, сайт, правила, группа Steam, Discord, регион. |
/api/v1/community/provider/{slug}/stats | Его игроки, игроки по регионам, режимы, серверы онлайн и всего. |
/api/v1/community/provider/{slug}/servers | Его серверы онлайн (массив). Необязательные фильтры: gamemode (slug режима или _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 | Итоги: игроки, серверы с игроками, игроки по регионам и режимам, исключённые фейковые и AFK-игроки, собственный счётчик Steam для игры. |
Поля сервера
ip, port (строка), name, reachable, provider (slug сообщества или 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— это реально играющие люди: боты, фейковые онлайны и AFK-аккаунты исключены. В/api/v1/statsplayingиregions— реальные активные люди на серверах, которые мы показываем (серверы сообщества и официальные серверы Valve для L4D2:community_playersиofficial_playersсчитают их отдельно);trading_players— их часть на серверах обмена и достижений TF2, аidle_map_players— люди на idle-картах, которые не входят вplaying(каждый сервер и режим по-прежнему показывает своих людей).humans— все, кто не бот.map_name_nextвсегда пустое: серверы не сообщают следующую карту в ответах на запросы.- Значения
colorу режимов — наши собственные. thumbnailкарты — ссылка на нашу копию картинки карты или null, если её нет;extra_infoиcontextпока null. История начинается 6 ноября 2026 года для TF2 и 8 ноября 2026 года для L4D2 и CS2.