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