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