tgs sources list#

Перечислить все диалоги Telegram в вашем аккаунте: каналы, супергруппы, группы, пользователей и ботов.

Использование#

tgs sources list [flags]

Флаги#

Порядок определения профиля, если --profile не указан: переменная TGS_PROFILE -> файл .tgs.yaml -> "default".

Примеры#

Список всех диалогов:

tgs sources list

Только каналы и супергруппы:

tgs sources list --type channel,supergroup

Получить статистику по каждому источнику (медленнее — ~4 API-запроса на источник):

tgs sources list --with-stats

Включить архивированные диалоги:

tgs sources list --archived

Только чаты из папки «Крипто» (включая архивные):

tgs sources list --folder Крипто

Постраничный обход большого аккаунта:

# Первая страница
tgs sources list --limit 50

# Следующая страница с курсором из предыдущего ответа
tgs sources list --limit 50 --cursor "eyJvIjo1MCwiZCI6MH0"

Вывод#

Возвращает JSON с массивом sources, полями total и returned, а также cursor для пагинации.

{
  "sources": [
    {
      "id": -1001234567890,
      "type": "channel",
      "title": "Durov's Channel",
      "username": "durov",
      "access": "public",
      "members_count": 1234567,
      "verified": true,
      "unread_count": 0,
      "last_message": {"id": 4321, "date": "2026-05-28T08:15:00Z"}
    },
    {
      "id": -1009876543210,
      "type": "supergroup",
      "title": "Go Programming",
      "username": "golang",
      "access": "public",
      "members_count": 78432,
      "has_topics": true,
      "unread_count": 5,
      "last_message": {"id": 120450, "date": "2026-05-28T07:42:11Z"}
    }
  ],
  "total": 287,
  "returned": 2,
  "cursor": "eyJvIjo1MCwiZCI6MH0"
}

total — число диалогов до фильтра и обрезки лимитом (всего в обходимой папке/папках), returned — len(sources), т.е. фактический размер ответа после применения --type и --limit. С --type-фильтром обычно returned < total.

При использовании --with-stats каждый источник также содержит объект stats:

{
  "stats": {
    "total_messages": 12345,
    "messages_24h": 3,
    "first_message": {"id": 1, "date": "2015-08-26T10:00:00Z"}
  }
}

Поля источника#

Поле cursor полностью отсутствует в JSON, когда больше нет результатов (оно не возвращается со значением ""). Итерируйте через jq -r '.cursor? // empty' для корректного завершения цикла.

Заметка о производительности#

По умолчанию tgs sources list работает быстро — читает список диалогов из вашего аккаунта. Флаг --with-stats делает примерно 4 дополнительных API-запроса на источник: channels.getFullChannel / messages.getFullChat / users.getFullUser для полной информации, messages.search для общего счётчика, плюс пагинированные messages.getHistory для подсчёта за 24 часа и поиска первого сообщения. Для аккаунтов с сотнями диалогов это может занять несколько минут. Статистика неактивных источников (последнее сообщение старше 7 дней) кешируется на диске и используется повторно между запусками.

Точность статистики#

• total_messages — серверный счётчик сообщений диалога.
• messages_24h — проходит до ~1000 последних сообщений и считает те, что попали в окно 24 часов; для гиперактивных источников значение упирается в этот лимит.
• first_message — best-effort: для broadcast-каналов Telegram MTProto иногда не возвращает самое старое сообщение, и поле просто отсутствует.

Смотрите также#

• tgs sources inspect