TGStat API Docs

# Получение статистики канала

Описание

Метод позволяет получить основные показатели статистики канала или чата.

Для каналов: кол-во подписчиков, средний охват публикации, рекламный охват за 12/24/48 часов, процент вовлеченности подписчиков (ERR), суммарный дневной охват, индекс цитирования (ИЦ), общее кол-во репостов и упоминаний канала

Для чатов: кол-во участников, DAU/WAU/MAU (активные участники за сутки/неделю/месяц), кол-во участников "онлайн" (в дневное/ночное время), кол-во сообщений (вчера/за неделю/за месяц/всего)

Метод доступен в "API Stat" (на всех тарифах)

Метод поддерживает работу как с каналами, так и с чатами

# Запрос

# URL запроса

GET

https://api.tgstat.ru/channels/stat

# Параметры

Параметр Описание Значение по умолчанию Обязательно
token Ваш токен Не задан Да
channelId Идентификатор канала/чата (@username, t.me/username, t.me/joinchat/AAAAABbbbbcccc... или ID канала в TGStat) Не задан Да

# Ответ

# Структура ответа для канала

{
    "status": "ok",
    "response": {
        "id": 118,                           # Внутренний ID канала в TGStat
        "title": "РИА Новости",              # Название канала
        "username": "@rian_ru",              # Username канала
        "peer_type": "channel",              # Тип (канал/чат)
        "participants_count": 2048184,       # Количество подписчиков канала на момент запроса
        "avg_post_reach": 541540,            # Средний охват публикации
        "adv_post_reach_12h": 475712,        # Средний рекламный охват публикации за 12 часов
        "adv_post_reach_24h": 554476,        # Средний рекламный охват публикации за 24 часа
        "adv_post_reach_48h": 580952,        # Средний рекламный охват публикации за 48 часов
        "err_percent": 26.4,                 # Процент вовлеченности подписчиков (ERR %)
        "err24_percent": 25.2,               # Процент вовлеченности подписчиков в просмотр поста за первые 24 часа (ERR24 %)
        "er_percent": 11.11,                 # Коэффициент вовлеченности подписчиков во взаимодействия с постом (реакция, пересылка, комментарий)        
        "daily_reach": 35496444,             # Cуммарный дневной охват
        "ci_index": 8737.68,                 # Индекс цитирования (ИЦ)
        "mentions_count": 171477,            # Количество упоминаний канала в других каналах
        "forwards_count": 472536,            # Количество репостов в другие каналы
        "mentioning_channels_count": 18740   # Количество каналов, упоминающих данный канал
        "posts_count": 53500,                # Общее количество неудаленных публикаций в канале
    }
}

# Структура ответа для чата

{
    "status": "ok",
    "response": {
        "id": 556877,                        # Внутренний ID чата в TGStat
        "title": "TGStat.ru Chat",           # Название чата
        "username": "@TGStat_Chat",          # Username чата
        "peer_type": "chat",                 # Тип (канал/чат)
        "participants_count": 4523,          # Количество участников чата на момент запроса
        "dau": 18,                           # DAU, кол-во активных участников за сутки
        "wau": 123,                          # WAU, кол-во активных участников за неделю
        "mau": 441,                          # MAU, кол-во активных участников за месяц
        "online_count_day_time": 1142,       # Количество участников "онлайн" в дневное время
        "online_count_night_time": 513,      # Количество участников "онлайн" в ночное время
        "messages_count_yesterday": 34,      # Количество сообщений за вчера
        "messages_count_last_week": 481,     # Количество сообщений за последнюю неделю
        "messages_count_last_month": 2302,   # Количество сообщений за последний месяц
        "messages_count_total": 108431       # Количество сообщений всего
    }
}

← Получение списка публикаций →