# Введение
TGStat предоставляет возможность получения представленных на сайте TGStat.com данных посредством программного интерфейса API.
# API статистики (API Stat)
Доступ к аналитическим показателям Telegram-каналов для Вашего приложения или сервиса (подойдет для рекламных бирж, каталогов, Telegram-сервисов, и др).
Доступные методы: channels/get, channels/search, channels/stat, channels/posts, channels/mentions, channels/forwards, channels/subscribers, channels/avg-posts-reach, channels/err, channels/views, posts/get, posts/stat, database/categories, database/countries, database/languages
Можно попробовать бесплатно на тарифе FREE для каналов (не более 2), владельцем которых вы являетесь. Платно для остальных каналов. С актуальными тарифами можно ознакомиться на странице Тарифы.
# API поиска (API Search)
Доступ к поиску по базе Telegram-публикаций, обновляемых в режиме реального времени (подойдет для сервисов, отслеживающих упоминания брендов, персон, дневной повестки в соцсетях).
Доступные методы: posts/search, words/mentions-by-period, words/mentions-by-channels, channels/get, posts/get, database/categories, database/countries, database/languages
С актуальными тарифами можно ознакомиться на странице Тарифы.
# API уведомлений (API Callback)
Получение уведомлений о выходе новых/редактировании/удалении публикаций, об упоминании ключевого слова в Telegram-публикациях на свой веб-сервер (подойдет для сервисов, которым необходимо отслеживать упоминания брендов, персон, и т.д. в режиме реального времени).
Доступные методы: callback/set-callback-url, callback/get-callback-info, callback/subscribe-channel, callback/subscribe-word, callback/subscriptions-list, callback/unsubscribe
С актуальными тарифами можно ознакомиться на странице Тарифы.
# Тарификация
Услуга доступа к API предоставляется с ограничением по общему количеству ежемесячных запросов, а также:
- по количеству уникальных каналов (для API Stat)
- по количеству уникальных ключевых слов (для API Search)
- по количеству отслеживаемых объектов (для API Callback)
Актуальные сведения об ограничениях на каждом из тарифов можно получить на странице Тарифы. Отслеживать расходование квоты по вашему пакету услуг можно с помощью метода usage/stat.
# Интеграция
Интеграция очень проста.
- Активируйте нужный тарифный план в Личном кабинете или на этой странице
- Получите персональный токен в своем Личном кабинете
- Ознакомьтесь с документацией
- Подпишитесь на наш Telegram-канал для получения уведомлений об изменениях в TGStat API
- Приступайте к использованию
Если возникли вопросы - пишите в Support.