2026-11-17 SocQ добавил платформу Telegram с шестью эндпоинтами для публичных Telegram-каналов. Вместе они закрывают весь цикл исследования: проверить канал, прочитать его ленту, получить конкретные публикации, прочитать обсуждение под публикацией, найти связанные каналы и поискать слово по истории канала.
В этом руководстве перечислено, что возвращает каждый эндпоинт, какой запрос он принимает, сколько стоит и когда его использовать. Все эндпоинты работают с публичными ссылками t.me и выполняются как асинхронные задачи SocQ.
Коротко: отправьте ссылку на публичный канал или публикацию на один из шести эндпоинтов
POST /v1/telegram/...с заголовкомAuthorization: Bearer $SOCQ_API_KEY. Сохраните возвращенныйtask_id, опрашивайтеGET /v1/tasks/{task_id}, покаstatusне станетsucceeded, и читайте записи вdata.results.items. Все эндпоинты тарифицируются за результат: 0.3 или 0.5 кредита за строку, то есть $0.0015 или $0.0025 при цене $0.005 за кредит.
Шесть новых эндпоинтов Telegram
| Эндпоинт | Что возвращает | Вход | Цена |
|---|---|---|---|
| Channel Info | Название, описание, аватар, значок верификации, число подписчиков | До 50 ссылок на каналы | 0.5 кредита ($0.0025) за канал |
| Channel Scraper | Публикации от новых к старым с текстом, временем, просмотрами, суммой реакций, фото и видео | Одна ссылка на канал | 0.3 кредита ($0.0015) за публикацию |
| Post Detail | Конкретные публикации с полным текстом, временем, просмотрами, реакциями и медиа | До 50 ссылок на публикации | 0.5 кредита ($0.0025) за публикацию |
| Comments | До 100 комментариев из связанной группы обсуждения с автором, текстом, временем, реакциями и комментарием, на который дан ответ | Одна ссылка на публикацию | 0.3 кредита ($0.0015) за комментарий |
| Similar Channels | Каналы, которые Telegram рекомендует рядом с каналом, с юзернеймом, названием, значком и подписчиками | Одна ссылка на канал | 0.5 кредита ($0.0025) за канал |
| Channel Search | Публикации из всей истории одного канала, совпадающие со словом или фразой | Одна ссылка на канал + запрос | 0.5 кредита ($0.0025) за найденную публикацию |
Все шесть тарифицируются только за возвращенные строки, без базовой платы за запрос.
Telegram Channel Info: пакетная проверка каналов
Telegram Channel Info API находит публичные каналы по ссылке t.me/name или t.me/s/name и возвращает одну строку на канал: название, описание, аватар, значок верификации и число подписчиков (metrics.followers_count). Используйте его, чтобы проверить канал перед спонсорской интеграцией, обновить список отслеживаемых новостных или криптоканалов или обогатить ссылки на каналы, собранные в других местах. Сырой файл результата также содержит число фото, видео и ссылок, которыми поделился каждый канал.
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"]
}'
Отправляйте до 50 ссылок за запрос. Ссылки на непубличные каналы пропускаются; задача завершается ошибкой с возвратом кредитов, только если не удалось прочитать ни одну из них. См. документацию Channel Info.
Telegram Channel Scraper: чтение ленты канала
Telegram Channel Scraper API читает публичный канал от последней публикации назад. Каждая публикация возвращается с текстом, временем публикации, числом просмотров, суммой эмодзи-реакций и реакций Stars, а также прикрепленными фото и видео. Получайте публикации за последние несколько дней для ежедневного дайджеста или увеличьте лимит, чтобы выгрузить историю канала.
curl -X POST "https://api.socq.ai/v1/telegram/channel-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/durov",
"results_limit": 20
}'
По умолчанию results_limit равен 20, допустимы значения от 1 до 1,000. Запрос к каналу, который невозможно прочитать, завершается ошибкой с возвратом кредитов. См. документацию Channel Scraper.
Telegram Post Detail: обновление известных публикаций
Если вы уже знаете, какие публикации важны, Telegram Post Detail API принимает их ссылки и возвращает каждую полностью: текст, время публикации, просмотры, сумму реакций, фото и видео. В одном запросе можно смешивать публикации из разных каналов, что удобно для обновления показателей отслеживаемых анонсов или публикаций кампаний. Сырой файл результата сохраняет число реакций по каждому эмодзи и источник пересылки.
curl -X POST "https://api.socq.ai/v1/telegram/post-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://t.me/durov/510"]
}'
Отправляйте до 50 ссылок в форме t.me/channel/post_id. Удаленные публикации и публикации в приватных каналах пропускаются. См. документацию Post Detail.
Telegram Comments: обсуждение под публикацией
Каналы, к которым привязана группа обсуждения, позволяют читателям комментировать каждую публикацию. Telegram Comments API читает эту ветку для одной публикации и возвращает каждый комментарий с именем автора, текстом, временем, суммой реакций и комментарием, на который он отвечает (parent_id). Используйте его, чтобы увидеть, как сообщество отреагировало на анонс, или передавать комментарии в процессы поддержки или исследований.
curl -X POST "https://api.socq.ai/v1/telegram/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/tginfo/4455",
"results_limit": 100
}'
По умолчанию results_limit равен 100, и это же максимум. Вы платите только за возвращенные комментарии. См. документацию Comments.
Telegram Similar Channels: карта ниши
На странице каждого публичного канала Telegram показывает ряд связанных каналов. Telegram Similar Channels API возвращает этот список для одного канала, обычно около десяти, в том порядке, в каком их показывает Telegram, каждый с юзернеймом, названием, значком верификации и числом подписчиков. Начните с конкурента или канала, в котором вы уже размещаете рекламу, чтобы расширить медиалист.
curl -X POST "https://api.socq.ai/v1/telegram/similar-channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/durov"
}'
См. документацию Similar Channels.
Telegram Channel Search: поиск по истории канала
Telegram Channel Search API ищет слово или фразу по всей истории публичного канала и возвращает найденные публикации с текстом, датой, просмотрами и реакциями. Проверьте, упоминал ли влиятельный канал когда-либо проект, или соберите все публикации канала о запуске.
curl -X POST "https://api.socq.ai/v1/telegram/channel-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/durov",
"query": "TON",
"results_limit": 20
}'
По умолчанию results_limit равен 20, допустимы значения от 1 до 100. Поиск без совпадений ничего не стоит. Фото в результатах поиска ссылаются на публикацию, в которой они показаны. См. документацию Channel Search.
Аутентификация и асинхронные задачи
Каждый запрос содержит ваш API-ключ и тип содержимого JSON:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Каждый вызов отправки запускает фоновую задачу:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Ответ на отправку возвращает data.task_id и data.status. Опрашивайте задачу с тем же ключом:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Пока задача находится в состоянии queued, running или failed, ответ содержит только метаданные задачи; при failed читайте error_message. Когда задача в состоянии succeeded, тот же ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. fields принимает до 50 полей или путей через точку, разделенных запятыми, если нужна более компактная проекция.
Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же task_id, а не отправляйте и не оплачивайте дубликат. Чтобы обойтись без опроса, добавьте callback_url в тело запроса; SocQ отправит один POST со сводкой задачи после ее завершения, а затем вы прочитаете записи через эндпоинт задачи.
Сколько стоит типичная задача
- Проверить 50 каналов через Channel Info: 50 × 0.5 = 25 кредитов, $0.125.
- Выгрузить 1,000 публикаций одного канала: 1,000 × 0.3 = 300 кредитов, $1.50.
- Прочитать 100 комментариев под анонсом: 30 кредитов, $0.15.
- Выполнить поиск по одному каналу и получить 20 совпадений: 10 кредитов, $0.05.
FAQ
Работают ли эти эндпоинты с приватными каналами или группами?
Нет. Они читают публичные каналы по ссылкам t.me. Channel Info и Post Detail пропускают ссылки, которые не удается прочитать, а Comments читает группу обсуждения, которую публичный канал привязал к своим публикациям.
Насколько глубоко в историю может заглянуть Channel Scraper?
Он читает от новых к старым, а results_limit принимает до 1,000 публикаций за запрос. Чтобы найти более старые публикации на определенную тему, используйте Channel Search, который ищет по всей истории канала.
Что входит в число реакций?
Для публикаций канала metrics.likes_count содержит сумму эмодзи-реакций и реакций Stars. Сырой файл результата Post Detail сохраняет число реакций по каждому эмодзи.
Платить ли за каналы или публикации, которые не найдены?
Нет. Оплата идет за каждую возвращенную строку, без базовой платы. Channel Search без совпадений ничего не стоит, а задача, в которой не удалось прочитать ни одной ссылки, завершается ошибкой с возвратом кредитов.
Как найти новые каналы для отслеживания?
Начните с одного известного вам канала и вызовите Similar Channels, затем передайте возвращенные ссылки в Channel Info, чтобы сравнить число подписчиков. Все эндпоинты — на странице платформы Telegram, текущие ставки — на странице цен.
TELEGRAM API
Проверить сценарий на публичном URL Telegram
Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.
API для Telegram