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
Отправьте список ссылок на каналы и прочитайте по одной строке для каждого найденного канала.
- Отправьте {"urls": ["https://t.me/durov", "https://t.me/tginfo"]} методом POST на /v1/telegram/channel-info.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте каналы из 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.
Связанные 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 совпавших публикаций с текстом, датой, просмотрами и реакциями.