telegram/
channel-search

Ищите слово или фразу во всей истории публикаций открытого Telegram-канала и получайте до 100 совпавших публикаций с текстом, датой публикации, просмотрами и реакциями.

Telegram Channel Search API

Вся история канала
До 100 совпадений
Просмотры и реакции
Без совпадений бесплатно
0,5 кредита за результат
Готово
Готово

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

README

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

Telegram Channel Search

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

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

  • Поиск по всей историиquery охватывает все публикации канала, поэтому упоминание многолетней давности находится так же легко, как сегодняшнее.
  • До 100 совпавших публикацийresults_limit задает, сколько совпадений вернуть, от 1 до 100, по умолчанию 20.
  • Просмотры и реакции для каждого совпаденияКаждая совпавшая публикация содержит metrics.views_count и metrics.likes_count, которые показывают, сколько внимания получило упоминание.
  • Оплата только за совпаденияКаждая совпавшая публикация стоит 0,5 кредита, а поиск без совпадений ничего не стоит.

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

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

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

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

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

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

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

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

  • Ищите отдельно по тикеру и по полному названию проекта, чтобы охватить оба варианта написания в канале.
  • Фото в результатах поиска ведут на публикацию, где они показаны; если нужны файлы изображений, отправьте url этой публикации в Telegram Post Detail API.
  • Каждый поиск охватывает один канал; чтобы найти другие каналы по теме, начните с известного канала в Telegram Similar Channels API.

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

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

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

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

Telegram Channel Search API — FAQ

Telegram Channel Search API — это программный интерфейс для поиска слова или фразы во всей истории публикаций открытого Telegram-канала. Он возвращает до 100 совпавших публикаций с текстом, датой публикации, просмотрами и реакциями.

Поиск идет внутри канала, переданного в url, по всей его истории. Чтобы найти новые каналы по теме, начните с известного канала в Telegram Similar Channels API.

До 100 совпавших публикаций, это задается через results_limit; по умолчанию 20.

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

Каждая возвращенная совпавшая публикация стоит 0,5 кредита, поэтому 20 результатов по умолчанию стоят 10 кредитов. Поиск без совпадений ничего не стоит.