telegram/
post-detail

Получайте конкретные публикации Telegram по ссылкам, до 50 за задачу и из любых открытых каналов вперемешку, с полным текстом, временем публикации, просмотрами, суммой реакций и медиа.

Telegram Post Detail API

До 50 публикаций в запросе
Разные каналы в одном запросе
Просмотры и реакции
Фото и видео
0,5 кредита за результат
Готово
Готово

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

README

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

Telegram Post Detail

Telegram Post Detail — это полная запись одной публикации канала с текстом, временем публикации, числом просмотров, суммой реакций и прикрепленными фото или видео. Чтение этих значений для уже известных публикаций позволяет обновлять цифры кампаний, фиксировать текст анонсов и добавлять данные об охвате к ссылкам в собственных базах.

Возможности Telegram Post Detail API

  • Публикации из многих каналов сразуurls принимает до 50 ссылок вида t.me/channel/post_id, и в одном запросе они могут вести на разные каналы.
  • Текущие просмотры и реакцииmetrics.views_count и metrics.likes_count дают целыми числами просмотры и сумму реакций на момент сбора.
  • Полный текст и медиаtext содержит весь текст публикации, а media перечисляет каждое фото или видео с типом и ссылкой на файл.
  • Недоступные публикации пропускаются без оплатыУдаленные публикации и публикации закрытых каналов не попадают в результаты и ничего не стоят; задача завершается ошибкой с возвратом, только если не удается прочитать ни одну ссылку.

Параметры Telegram Post Detail API

ПараметрыОбязательныйОписание
urlsОбязательныйДо 50 ссылок на публикации Telegram вида https://t.me/channel/post_id, например https://t.me/durov/510. Ссылки из разных открытых каналов можно смешивать.

Как использовать Telegram Post Detail API

Отправьте ссылки на нужные публикации и прочитайте полную запись для каждой найденной.

  1. Отправьте {"urls": ["https://t.me/durov/510"]} методом POST на /v1/telegram/post-detail.
  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/post-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://t.me/durov/510"]}'

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

  • Обновление цифр кампании: Храните ссылки на спонсорские публикации и анонсы и регулярно собирайте их заново, чтобы видеть динамику просмотров и реакций.
  • Фиксация текста публикации: Сохраняйте точный текст и время публикации, на которую ссылаются в отчете, споре или новости, вместе с collected_at.
  • Дополнение пересланных ссылок: Превращайте ссылки на публикации из чатов, статей и таблиц в полные записи с каналом-источником, охватом и медиа.

Практические советы по Telegram Post Detail API

  • Объединяйте ссылки из многих каналов в один запрос до 50 штук вместо отправки по одной.
  • author.username указывает канал каждой публикации, что удобно для группировки смешанного пакета по каналам.
  • Чтобы собрать последние публикации канала, не зная ссылок, используйте Telegram Channel Scraper API; Post Detail подходит для публикаций, на которые вы уже можете сослаться.

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

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

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

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

Telegram Post Detail API — FAQ

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

Ссылка должна содержать канал и номер публикации, например https://t.me/durov/510. Формы t.me/s/, telegram.me и telegram.dog той же ссылки тоже принимаются.

Да. До 50 ссылок можно свободно смешивать, а поля author в каждой строке показывают, из какого канала публикация.

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

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