TGStat API

Зарегистрирован в реестре блогеров

Метод channels/get теперь возвращает информацию о наличии канала в реестре блогеров РКН.

Документация

API TGStat в публичном каталоге Postman

Подготовили для пользователей API TGStat коллекцию методов и опубликовали ее в каталоге Postman, чтобы работа с нашими API-сервисами доставляла сплошное удовольствие. Вы можете сразу начать работать с API TGStat без необходимости вручную подготавливать запросы. Более 30-методов нашего API с примерами и описанием теперь доступны в 2 клика.

Что такое Postman?

Postman — это популярный инструмент среди разработчиков, позволяющий тестировать, документировать и делиться своими API. С помощью Postman можно быстро создавать запросы, проверять ответы и автоматизировать тестирование API, экономя при этом массу времени.

Postman имеет настольные приложения для всех операционных систем, а также версию для использования прямо в браузере.

Как использовать?

🟢Способ 1: Импортировать коллекцию по ссылке

– Нажать кнопку Import в своем приложении Postman
– Указать ссылку https://api.tgstat.ru/postman.json
– В вашем воркспейсе появится коллекция «TGStat API» со всеми доступными методами
– Заполните переменную {{TGSTAT_TOKEN}}. Получить токен можно в личном кабинете TGStat
– Готово, можно выполнять запросы

🟢Способ 2: Сделать Fork нашего проекта

– Перейти по ссылке https://www.postman.com/tgstat
– Нажать кнопку Fork
– В вашем воркспейсе появится коллекция «TGStat API» со всеми доступными методами
– Заполните переменную {{TGSTAT_TOKEN}}. Получить токен можно в личном кабинете TGStat
– Готово, можно выполнять запросы

Работоспособность восстановлена, все сервисы снова работают в штатном режиме!

Посты, опубликованные за последний час пока что могут быть недоступны в поиске (еще примерно в течение 1 часа).

Сломался один из дисков поискового кластера 😢

Поиск по публикациям и связанные с поиском методы API временно не работают. Восстановление работоспособности сервисов займет примерно 3 часа.

Приносим свои извинения за неудобства 🍃

Новый метод stories/stat-multi для получения статистики сразу нескольких сторис из канала.

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

Принимает:
▪️ID канала
▪️ID сторис через запятую (до 50 штук)

Возвращает для каждой сторис:
▪️Количество просмотров
▪️Количество пересылок
▪️Количество реакций

Документация:
https://api.tgstat.ru/docs/ru/stories/stat-multi.html

Добавлен метод для получения списка Stories в канале:

👍 Метод channels/stories - позволяет получить список историй из указанного канала. Возвращает истории канала, отсортированные в обратном хронологическом порядке (последние сверху).

Документация

Добавлены новые методы для работы со Stories:

👍 Метод stories/get - покажет информацию об истории, по аналогии с методом posts/get (для публикации)

👍 Метод stories/stat - покажет статистику истории (кол-во просмотров, реакций, пересылок, а также динамику роста просмотров по часам)

✔️ В ответ метода channels/stat добавлены следующие показатели:

– err24_percent
Коэффициент вовлеченности подписчиков за первые 24 часа

– er_percent
Коэффициент вовлеченности подписчиков по взаимодействиям с постом (реакция, пересылка, комментарий)

– posts_count
Общее количество неудаленных публикаций в канале

✔️ Добавлены новые методы:

– channels/er
Метод позволяет получить показатель "ER" в динамике по дням, неделям, месяцам

– channels/err24
Метод позволяет получить показатель "ERR24" в динамике по дням, неделям, месяцам

TGStat проводит масштабное исследование аудитории Telegram 2023

Команда подготовила простой, но подробный опрос, чтобы узнать, что из себя представляет аудитория мессенджера на 2023 год.

Призываем всех пройти опрос, а администраторов поделиться ссылкой на опрос в своих каналах и чатах.

Ссылка на опрос:
https://tgstat.ru/research

Некоторые методы TGStat API теперь поддерживают работу с чатами

👍 Метод channels/get теперь доступен и для чатов

👍 Метод channels/search теперь ищет и по чатам тоже, если передать атрибут peer_type = chat

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

👍 Метод channels/subscribers для получения динамики роста подписчиков теперь доступен и для чатов

Поддержка коллекционных юзернеймов в TGStat API

👍 Если у канала одновременно несколько активных юзернеймов, информация об этом будет доступна массиве active_usernames объекта Channel

👍 В параметре channelId теперь можно передавать как основной юзернейм, так и любой из альтернативных. Канал будет найден по любому из них.

Документация

Новый метод posts/stat-multi:

Подготовили новый метод для получения статистики сразу нескольких публикаций. Метод доступен в "API Stat" (на тарифе XL).

Принимает:
▪️ID канала
▪️ID постов через запятую (до 50 штук)

Возвращает для каждой публикации:
▪️Количество просмотров
▪️Количество пересылок
▪️Количество комментариев
▪️Количество реакций

Документация:
https://api.tgstat.ru/docs/ru/posts/stat-multi.html

С Наступающим, Админы! 🥂🥂

Такую красоту для своего канала/чата можно получить отправив запрос нашему боту.

В этом году мы посчитали все ваши просмотры, пересылки, комментарии, реакции, упоминания и репосты в сумме за весь 2022 год.

Вдобавок, появилась возможность получить новогоднюю статистику не только для канала, но и для чата 😲

Как получить открытку?
- Переходим в бота @TGStat_Bot
- Отправляем команду "2022 @username", подставив username/ссылку на свой канал
- Наслаждаемся красотой
- Делимся с подписчиками

Всем добра 🎉

@TGStat 👍

Новые параметры для метода posts/search

Для метода posts/search стали доступны параметры для фильтрации публикаций по стране, языку и категории.

Документация:
https://api.tgstat.ru/docs/ru/posts/search.html

Изменения в методе posts/stat:

Теперь с помощью метода можно получать следующие параметры статистики публикации:

▪️Количество пересылок публикации
▪️Количество комментариев к публикации
▪️Количество реакций к публикации

Документация:
https://api.tgstat.ru/docs/ru/posts/stat.html

Изменения в методе channels/stat:

Теперь с помощью метода можно получать следующие параметры статистики канала:

▪️Рекламный охват за 12/24/48 часов
▪️Общее кол-во упоминаний канала в других каналах
▪️Общее кол-во репостов в другие каналы
▪️Количество каналов, упоминающих данный канал

Документация:
https://api.tgstat.ru/docs/ru/channels/stat.html

API Changelog:

Добавлена возможность получать статистику роста подписчиков и просмотров публикаций в динамике по часам.

▪️Метод channels/subscribers:
- расширен набор значений для параметра group. Теперь он может принимать значение hour для выдачи почасовой статистики.

▪️Метод posts/stat:
- добавлен параметр group. Допустимые значения: day | hour для получения статистики просмотров публикации с группировкой по дням или по часам.

▪️Объект Channel теперь содержит информацию о наличии красной или черной метки у канала.

Документация:
https://api.tgstat.ru/docs

API Changelog:

▪️Метод posts/search:
- добавлена поддержка расширенного синтаксиса запросов
- добавлен фильтр peerType, для возможности поиска публикаций "только по каналам", или "только по чатам"

▪️Методы words/mentions и words/reach объявлены deprecated:
- для получения данных, возвращаемых этими методами надо использовать новый метод words/mentions-by-period
- добавлена поддержка расширенного синтаксиса запросов

▪️Добавлен метод words/mentions-by-channels для получения количества упоминаний и суммарного охвата ключевого слова в разрезе каналов. С помощью данного метода на tgstat.ru/search выводится панель упоминающих каналов с количеством упоминаний в каждом из каналов.

▪️Добавлен метод channels/search для поиска каналов по ключевым словам и получения списка каналов внутри категории. С помощью данного метода работает наш @SearcheeBot.

▪️Добавлено описание расширенного синтаксиса запросов.

▪️API поиска публикаций подключен к Realtime-индексу, в который новые публикации из Telegram поступают в режиме реального времени.

Документация:
https://api.tgstat.ru/docs