Telegram Public Data API
Читайте открытые Telegram-каналы по ссылкам t.me: профили каналов с числом подписчиков, публикации с просмотрами и реакциями, отдельные публикации, комментарии из групп обсуждения, похожие каналы и поиск по всей истории.
Доступные API Telegram
Channel Info, Channel Scraper, Similar Channels и Channel Search начинают со ссылки на канал, Post Detail и Comments — со ссылки на публикацию, а каждый результат содержит ссылки, которые можно сразу передать в следующий эндпоинт.

telegram/channel-info
Профили0,5 кредита за результат

telegram/channel-posts
Публикации0,3 кредита за результат

telegram/post-detail
Публикации0,5 кредита за результат

telegram/post-comments
Комментарии0,3 кредита за результат

telegram/similar-channels
Профили0,5 кредита за результат

telegram/channel-search
Поиск0,5 кредита за результат
Какие данные Telegram можно получить?
Каждый эндпоинт возвращает стабильные записи SocQ, собранные из того, что открытый канал показывает любому посетителю.
Профили каналов
Имя пользователя, название, описание, аватар, значок верификации и число подписчиков целым числом, до 50 каналов в одном запросе.
Публикации и медиа
Текст, время публикации, просмотры, сумма реакций вместе с платными реакциями Star и ссылки на фото и видео: до 1 000 публикаций от новых к старым или до 50 публикаций по ссылкам.
Комментарии из групп обсуждения
Имя автора, текст, время и реакции до 100 комментариев к публикации, а также parent_id и post_id для восстановления веток ответов.
Похожие каналы
Каналы, которые Telegram рекомендует рядом с каналом, обычно около десяти, в порядке Telegram и с точным числом подписчиков.
Поиск внутри канала
До 100 публикаций, где слово или фраза встречается в любой точке истории канала, каждая с просмотрами и реакциями.
SocQ и Telegram API
Собственный API Telegram предназначен для создания приложений и ботов Telegram. SocQ возвращает данные открытых каналов в виде нормализованных записей, которые удобно хранить, сравнивать и объединять.
| Возможность | SocQ | Telegram API |
|---|---|---|
| Доступ | API-ключ SocQ | ID приложения Telegram с авторизованным аккаунтом или токен бота |
| Входные данные | Публичные ссылки t.me на каналы и публикации | Идентификаторы объектов Telegram, полученные в клиентской сессии |
| Результат | Нормализованные JSON-записи с целочисленными счетчиками | Нативные объекты Telegram |
| Режим работы | Асинхронные задачи с сохраненными постраничными результатами | Прямые вызовы из вашего собственного клиента |
Как работают API Telegram
Все шесть эндпоинтов используют один и тот же асинхронный цикл: отправка, опрос и чтение.
1. Начните со ссылки
Отправьте ссылку на канал в Channel Info, Channel Scraper, Similar Channels или Channel Search, а ссылку на публикацию — в Post Detail или Comments.
2. Опрашивайте задачу
Используйте полученный task_id с /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
3. Связывайте результаты
Передавайте url публикаций из Channel Scraper или Channel Search в Comments или Post Detail, а url каналов из Similar Channels — в Channel Info.
Пройдите аутентификацию с API-ключом SocQ. Channel Scraper по умолчанию возвращает 20 публикаций и принимает до 1 000.
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}'
# Затем прочитайте комментарии к одной публикации:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# Опрашивайте GET /v1/tasks/{task_id}Типичные сценарии использования API Telegram
Проверка перед рекламой
Проверьте подписчиков и верификацию через Channel Info, а свежие просмотры через Channel Scraper, прежде чем оплачивать размещение.
Дайджесты и оповещения по каналам
Регулярно собирайте последние публикации новостных, рыночных и проектных каналов и отправляйте новые тексты и ссылки в сводки или оповещения.
Обратная связь сообщества
Забирайте комментарии под анонсами и группируйте их по темам, чтобы видеть реакцию читателей и повторяющиеся вопросы.
Карта ниши
Двигайтесь от стартовых каналов вширь с помощью Similar Channels и собирайте список связанных каналов с размером их аудитории.
Исследование упоминаний
Ищите бренд, токен или продукт во влиятельных каналах и оценивайте, сколько внимания получило каждое упоминание.
Охват данных
Результаты отражают то, что открытые Telegram-каналы показывают любому посетителю на момент сбора.
- Все эндпоинты читают открытые каналы, которые задаются именем пользователя канала или номером публикации внутри канала.
- Комментарии берутся из группы обсуждения, которую канал привязал к своим публикациям, до 100 на публикацию за одну задачу.
- Similar Channels возвращает рекомендации, которые Telegram показывает для канала, обычно около десяти.
- Channel Search за один запрос ищет внутри одного канала по всей его истории и возвращает до 100 совпадений.
- Счетчики — это снимки на момент collected_at, а ссылки на файлы фото и видео временные, поэтому нужные файлы лучше скачивать сразу.
Частые вопросы об API Telegram
Что такое Telegram API?
Telegram API — это набор эндпоинтов SocQ, которые читают открытые Telegram-каналы по ссылкам и возвращают профили каналов, публикации, комментарии из групп обсуждения, похожие каналы и результаты поиска внутри канала в виде нормализованных JSON-записей.
Какие API Telegram доступны?
Telegram Channel Info API, Telegram Channel Scraper API, Telegram Post Detail API, Telegram Comments API, Telegram Similar Channels API и Telegram Channel Search API.
Нужен ли аккаунт Telegram или токен бота?
Нет. Запросы используют ваш API-ключ SocQ и ссылку на открытый канал или публикацию.
Какие форматы ссылок принимаются?
Ссылки на каналы вроде t.me/durov или t.me/s/durov, их варианты с telegram.me и telegram.dog, а также ссылки на публикации вроде t.me/durov/510 для Post Detail и Comments.
В каком виде возвращаются подписчики и просмотры?
Целыми числами. Сокращенные подписи Telegram вроде 9.95M или 661K переводятся в целые числа, а Similar Channels возвращает точное число подписчиков.
Как тарифицируются эндпоинты?
Channel Info, Post Detail, Similar Channels и Channel Search стоят 0,5 кредита за каждый возвращенный результат, а Channel Scraper и Comments — 0,3 кредита за публикацию или комментарий. Нечитаемые ссылки пропускаются, или кредиты за них возвращаются, а публикации без комментариев и поиск без совпадений ничего не стоят.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
Link in Bio API
Превращайте единственную ссылку из био автора в Instagram, TikTok или YouTube в структурированные данные: отображаемое имя, био, аватар, указанный контактный email, связанные профили в соцсетях и каждую кнопку страницы с заголовком и адресом.
Creator API
Начните с одного профиля в Instagram, TikTok, YouTube, X, Facebook или Threads и найдите публичные деловые email автора, его аккаунты в других сетях или оценку возраста и пола по фото профиля.
Google Hotels API
Ищите отели по направлению, открывайте полную карточку любого отеля в Google Hotels и получайте его календарь цен за ночь — всё связано одним ID отеля.
Brand Monitoring API
Находите веб-страницы, где упоминается бренд, продукт или тема, оценивайте каждую по тональности и эмоциям и подводите итог тому, как о них говорят в интернете.
AI Search API
Отслеживайте, как AI Overviews, ChatGPT и Google AI Mode отвечают на вопросы вашего рынка: ответы, где назван ваш бренд, насколько вы заметны и какие домены и страницы цитируются.
Instagram API
Получайте или находите публичные профили и собирайте записи списков подписчиков, подписки, собственные публикации, публикации с отметкой профиля, результаты по хештегам, Reels, расшифровки, комментарии, счетчики аккаунтов, метрики вовлеченности и метаданные медиа в рамках одного асинхронного процесса.