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
Отправьте ссылку на канал и поисковый запрос и прочитайте совпавшие публикации.
- Отправьте {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} методом POST на /v1/telegram/channel-search.
- Опрашивайте 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-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.
Связанные 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 рекомендует рядом с открытым каналом, обычно около десяти, с названием, значком верификации и точным числом подписчиков.