telegram/
channel-info

Получайте данные публичных Telegram-каналов по ссылкам t.me, до 50 за раз: название, описание, аватар, значок верификации и число подписчиков каждого канала.

Telegram Channel Info API

До 50 каналов в запросе
Подписчики числом
Значок верификации
Ссылки t.me и t.me/s
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Telegram Channel Info

Telegram Channel Info — это публичный профиль канала, который состоит из имени пользователя, названия, описания, аватара, значка верификации и числа подписчиков. Эти несколько сигналов показывают, насколько велик канал, подтвердил ли его Telegram и о чем он заявляет писать, что помогает проверять каналы перед рекламой, вести списки наблюдения и дополнять базы каналов.

Возможности Telegram Channel Info API

  • До 50 каналов в одной задачеВ urls можно смешивать ссылки t.me/name, t.me/s/name, telegram.me и telegram.dog; повторяющийся канал запрашивается один раз, а каждый найденный канал дает одну строку.
  • Подписчики целым числомmetrics.followers_count переводит сокращенную запись Telegram вроде 9.95M в целое число вроде 9950000, готовое для сортировки, фильтров и пороговых значений.
  • Данные канала и верификация в одной строкеusername, name, text и avatar_url описывают канал, а is_verified показывает, есть ли у него значок верификации Telegram.
  • Нечитаемые ссылки пропускаются без оплатыСсылка на закрытый или удаленный канал не попадает в результаты и ничего не стоит, а остальные каналы из пакета возвращаются как обычно.

Параметры Telegram Channel Info API

ПараметрыОбязательныйОписание
urlsОбязательныйДо 50 ссылок на публичные Telegram-каналы, например https://t.me/durov или https://t.me/s/durov. Подходят и ссылки telegram.me и telegram.dog, а повторяющийся канал запрашивается один раз.

Как использовать Telegram Channel Info API

Отправьте список ссылок на каналы и прочитайте по одной строке для каждого найденного канала.

  1. Отправьте {"urls": ["https://t.me/durov", "https://t.me/tginfo"]} методом POST на /v1/telegram/channel-info.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте каналы из results.items, а пока has_more равно true, передавайте results.next_cursor, чтобы загрузить следующую страницу.
curl -X POST "https://api.socq.ai/v1/telegram/channel-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://t.me/durov","https://t.me/tginfo"]}'

Сценарии использования Telegram Channel Info API

  • Проверка канала перед рекламой: Сравните число подписчиков, статус верификации и описание канала, прежде чем соглашаться на платное размещение.
  • Актуальный список наблюдения: Регулярно запускайте один и тот же список и сохраняйте followers_count вместе с collected_at, чтобы следить за ростом крипто-, новостных и нишевых каналов.
  • Дополнение ссылок из других источников: Превратите столбец ссылок t.me из таблицы, поиска или списка партнеров в названия, описания и размеры аудитории.

Практические советы по Telegram Channel Info API

  • Используйте возвращенный username как ключ: t.me/name и t.me/s/name ведут на один канал и дают одинаковый id, поэтому повторные запросы легко объединяются.
  • Ссылка на публикацию вроде https://t.me/durov/510 читается как ее канал; чтобы получить саму публикацию, отправьте ее в Telegram Post Detail API.

Помимо Telegram Channel Info API, используйте эти API, когда нужен другой тип публичных данных Telegram.

  • Telegram Channel Scraper API — Собирайте до 1 000 публикаций открытого Telegram-канала от новых к старым с текстом, временем, просмотрами, суммой реакций, фото и видео.
  • Telegram Post Detail API — Получайте по ссылкам до 50 конкретных публикаций Telegram из любых открытых каналов с полным текстом, временем, просмотрами, реакциями и медиа.
  • Telegram Comments API — Собирайте до 100 комментариев под публикацией Telegram-канала из ее группы обсуждения с автором, текстом, временем, реакциями и комментарием, на который дан ответ.
  • Telegram Similar Channels API — Находите каналы, которые Telegram рекомендует рядом с открытым каналом, обычно около десяти, с названием, значком верификации и точным числом подписчиков.
  • Telegram Channel Search API — Ищите слово или фразу во всей истории открытого Telegram-канала и получайте до 100 совпавших публикаций с текстом, датой, просмотрами и реакциями.

Другие платформы

Объединяйте данные Telegram с публичными данными других поддерживаемых соцсетей.

Telegram Channel Info API — FAQ

Telegram Channel Info API — это программный интерфейс для получения данных публичных Telegram-каналов по их ссылкам, до 50 в одном запросе. Он возвращает для каждого канала имя пользователя, название, описание, аватар, значок верификации и число подписчиков.

Ссылки на каналы вида t.me/name или t.me/s/name, а также ссылки telegram.me и telegram.dog. Имя пользователя канала начинается с буквы и содержит от 5 до 32 символов.

Закрытые или удаленные каналы пропускаются и не оплачиваются, а остальная часть пакета возвращается как обычно. Если не удается прочитать ни одну ссылку, задача завершается ошибкой и кредиты возвращаются.

Telegram часто показывает число подписчиков в сокращенном виде, например 9.95M, и оно переводится в соответствующее целое число. Когда Telegram публикует точное значение, возвращается именно оно.

Каждый возвращенный канал стоит 0,5 кредита, поэтому запрос с 50 читаемыми ссылками стоит 25 кредитов. Пропущенные ссылки бесплатны.