telegram/
channel-posts

Собирайте публикации открытого Telegram-канала от самой свежей назад, до 1 000 за задачу, с текстом, временем публикации, просмотрами, суммой реакций и прикрепленными фото и видео.

Telegram Channel Scraper API

До 1 000 публикаций
Сначала новые
Просмотры и реакции
Фото и видео
0,3 кредита за результат
Готово
Готово

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

README

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

Telegram Channel Scraper

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

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

  • Сначала новые, до 1 000 публикацийresults_limit задает, сколько публикаций собрать, от 1 до 1 000, по умолчанию 20, а лента читается назад от самой свежей публикации.
  • Просмотры целыми числамиmetrics.views_count переводит сокращенные счетчики Telegram вроде 661K в целые числа, чтобы публикации можно было сразу сравнивать и суммировать.
  • Сумма реакций вместе со Starsmetrics.likes_count складывает все реакции на публикацию, и эмодзи, и платные реакции Star, в одно значение вовлеченности.
  • Фото и видео каждой публикацииmedia перечисляет каждое вложение с его типом, image или video, и прямой ссылкой на файл.
  • Стабильные ID публикацийid каждой строки объединяет канал и номер публикации, например durov/564, а url ведет прямо на публикацию.

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

ПараметрыОбязательныйОписание
urlОбязательныйОдна ссылка на открытый Telegram-канал, например https://t.me/durov; подходят и формы t.me/s/, telegram.me и telegram.dog.
results_limitНеобязательныйСколько публикаций собрать, от новых к старым. Целое число от 1 до 1 000, по умолчанию 20.

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

Отправьте ссылку на канал и лимит публикаций и читайте публикации от новых к старым.

  1. Отправьте {"url": "https://t.me/durov", "results_limit": 20} методом POST на /v1/telegram/channel-posts.
  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-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov","results_limit":20}'

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

  • Ежедневный дайджест каналов: Каждое утро забирайте последние 20–50 публикаций и сводите в обзор то, что набор новостных или рыночных каналов опубликовал за ночь.
  • Сравнение контента по просмотрам: Сортируйте свежие публикации канала по views_count и likes_count, чтобы понять, какие форматы и темы удерживают читателей.
  • Наполнение архива канала: Один раз задайте большой results_limit, чтобы забрать историю канала, а в следующих запусках собирайте только новые публикации.
  • Мониторинг каналов с анонсами: Следите за каналами проектов и брендов и отправляйте текст и ссылки новых публикаций в оповещения или исследовательскую базу.

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

  • Сравнивайте published_at с прошлым запуском и прекращайте сохранение, как только дойдете до уже сохраненных публикаций: так плановые запуски остаются небольшими и недорогими.
  • Скачивайте нужные фото и видео вскоре после сбора: ссылки на файлы Telegram действуют ограниченное время.
  • Просмотры и реакции фиксируются на момент сбора, поэтому сохраняйте collected_at с каждым снимком и сравнивайте публикации близкого возраста.

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

  • Telegram Channel Info API — Получайте по ссылкам данные до 50 публичных 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 Scraper API — FAQ

Telegram Channel Scraper API — это программный интерфейс для сбора публикаций открытого Telegram-канала от новых к старым, до 1 000 за задачу. Каждая публикация содержит текст, время публикации, число просмотров, сумму реакций и прикрепленные медиа.

От 1 до 1 000, это задается через results_limit; по умолчанию 20. Публикации приходят от новых к старым, поэтому небольшой лимит дает самую свежую активность.

В Telegram likes_count содержит сумму всех реакций на публикацию и объединяет эмодзи-реакции и платные реакции Star в одно число.

Открытые каналы, указанные ссылкой вида t.me/name, t.me/s/name, telegram.me или telegram.dog. Если канал прочитать не удается, например потому что он закрытый, задача завершается ошибкой и кредиты возвращаются.

URL фото и видео ведут на файловые серверы Telegram и действуют ограниченное время. Скачивайте нужные файлы вскоре после завершения задачи.

Каждая возвращенная публикация стоит 0,3 кредита, поэтому 20 публикаций по умолчанию стоят 6 кредитов, а 1 000 публикаций — 300 кредитов.