Telegram Search -- поиск в Telegram-каналах

Описание

Процессор Telegram Search выполняет поиск сообщений в публичных Telegram-каналах и группах через API TGStat. Он позволяет находить публикации по ключевым словам, фильтровать по дате, отсекать удаленные и пересланные сообщения, а также собирать метаданные каналов (количество подписчиков, тематика, статистика вовлеченности).

Процессор автоматически разбивает длинные периоды на интервалы, обрабатывает пагинацию и дедуплицирует результаты. Каждый найденный пост создается как отдельный DataPacket с полной информацией о канале-источнике.

Сценарии использования

• Мониторинг упоминаний бренда или компании в Telegram-каналах
• Поиск тематических публикаций для анализа трендов в отрасли
• Сбор лидов из объявлений в профильных каналах (запросы на услуги, тендеры)
• Отслеживание новостей конкурентов и рынка
• Поиск каналов с целевой аудиторией для рекламных размещений
• Мониторинг отзывов и обратной связи в отраслевых сообществах

Конфигурация

Параметр	Тип	Обязательный	По умолчанию	Описание
query	string	Да	—	Поисковый запрос. Поддерживает ключевые слова и фразы
dateFrom	string (ISO)	Нет	—	Дата начала периода поиска (ISO 8601). Альтернативное поле: fromDate
dateTo	string (ISO)	Нет	—	Дата окончания периода поиска (ISO 8601). Альтернативное поле: endDate
hideDeleted	boolean	Нет	false	Скрывать удаленные сообщения
hideForwards	boolean	Нет	false	Скрывать пересланные (форвардные) сообщения
postsLimit	number	Нет	—	Ограничение общего количества постов в результатах
maxPackets	number	Нет	50	Максимальное количество DataPackets для создания
searchOnlyNew	boolean	Нет	false	Искать только новые посты с момента последнего успешного запуска
internationalSearch	boolean	Нет	false	Международный поиск. По умолчанию поиск только по российским каналам

Входные данные

Telegram Search является процессором-источником и работает как первый процессор в цепочке. Он не требует входных данных от других процессоров — поиск выполняется по заданному запросу.

Выходные данные

Каждый найденный пост создает отдельный DataPacket со следующей структурой:

{
  "text_hash": "a1b2c3d4e5f6...",
  "post_id": 12345,
  "published_at": "2026-03-01T14:30:00.000Z",
  "text": "Полный текст публикации...",
  "link": "https://t.me/channelname/12345",
  "total_posts": 5420,
  "total_views": 15000,
  "total_shares": 230,
  "total_reactions": 450,
  "total_comments": 67,
  "channel_link": "https://t.me/channelname",
  "channel_title": "Название канала",
  "channel_type": "channel",
  "channel_about": "Описание канала...",
  "channel_country": "Россия",
  "channel_language": "ru",
  "channel_category": "Бизнес",
  "participants_count": 25000,
  "posts_links": ["https://t.me/channelname/12345"],
  "channel_links": ["https://t.me/channelname"]
}

Описание полей

Поле	Описание
text_hash	Хеш текста для дедупликации
post_id	ID поста в TGStat
published_at	Дата и время публикации
text	Полный текст сообщения
link	Прямая ссылка на пост
total_posts	Общее количество постов в канале
total_views	Количество просмотров поста
total_shares	Количество репостов
total_reactions	Количество реакций
total_comments	Количество комментариев
channel_link	Ссылка на канал
channel_title	Название канала
channel_type	Тип: channel или group
channel_about	Описание канала
channel_country	Страна канала
channel_language	Язык канала
channel_category	Категория канала
participants_count	Количество подписчиков канала

Стоимость

Поиск в Telegram расходует токены на каждый API-вызов к TGStat. Количество API-вызовов зависит от ширины временного периода и объема результатов (автоматическая разбивка на интервалы для больших объемов). Стоимость отображается в логах выполнения.

Примеры

Мониторинг упоминаний бренда

{
  "query": "aiWarmUp",
  "searchOnlyNew": true,
  "hideDeleted": true,
  "hideForwards": false,
  "maxPackets": 50
}

Поиск запросов на услуги в отрасли

{
  "query": "ищу подрядчика разработка",
  "dateFrom": "2026-02-01T00:00:00Z",
  "dateTo": "2026-03-01T00:00:00Z",
  "hideDeleted": true,
  "hideForwards": true,
  "maxPackets": 100
}

Международный поиск

{
  "query": "SaaS B2B sales",
  "internationalSearch": true,
  "searchOnlyNew": true,
  "postsLimit": 200,
  "maxPackets": 50
}

Связанные процессоры

• GPT Filter — фильтрует найденные посты по релевантности с помощью ИИ (например, “оставить только посты с запросами на услуги”)
• CRM Update — передает отфильтрованные лиды из Telegram-постов в CRM-систему
• AI Search — дополнительный поиск информации о компаниях, упомянутых в постах
• Contact Search — поиск контактов авторов или упомянутых компаний