Telegram Channel Search
Telegram Channel Search recorre cada publicación que un canal público ha difundido en busca de una palabra o frase, y devuelve las publicaciones coincidentes con su texto, fecha de publicación, vistas y reacciones. Encontrar esas menciones, por antiguas que sean, muestra si un canal influyente habló alguna vez de un proyecto, con qué frecuencia vuelve a un tema y cuánta atención recibió cada mención.
Funcionalidades de la Telegram Channel Search API
- Busca en todo el historialquery recorre todas las publicaciones del canal, así que una mención de hace años aparece tan fácilmente como una de hoy.
- Hasta 100 publicaciones coincidentesresults_limit fija cuántas coincidencias se devuelven, de 1 a 100 con 20 de forma predeterminada.
- Vistas y reacciones por coincidenciaCada publicación coincidente trae metrics.views_count y metrics.likes_count, que muestran cuánta atención recibió la mención.
- Solo se cobran las coincidenciasCada publicación coincidente cuesta 0.5 créditos, y una búsqueda sin coincidencias no cuesta nada.
Parámetros de la Telegram Channel Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | Un enlace de canal público de Telegram en el que buscar, como https://t.me/durov; también funcionan los enlaces t.me/s/, telegram.me y telegram.dog. |
query | Obligatorio | Palabra o frase que se busca en las publicaciones del canal, como TON. |
results_limit | Opcional | Número de publicaciones coincidentes que se devuelven. Entero de 1 a 100; el valor predeterminado es 20. |
Cómo usar la Telegram Channel Search API
Envíe un enlace de canal y un término de búsqueda, y lea las publicaciones coincidentes.
- Envíe {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} por POST a /v1/telegram/channel-search.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea las publicaciones coincidentes en results.items y, mientras has_more sea true, pase results.next_cursor para cargar la página siguiente.
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}'Casos de uso de la Telegram Channel Search API
- Comprobar si un canal habló de un proyecto: Busque el nombre de su token, producto o marca en un canal de influencers o de noticias antes de proponer una alianza.
- Reunir la cobertura de un lanzamiento: Junte en una lista todas las publicaciones que un canal dedicó a un lanzamiento de producto o a un evento, para hacer un balance.
- Revisión antes de comprar un espacio: Busque en un canal promociones pasadas de un competidor o de un tema para conocer su historial antes de comprarle un espacio publicitario.
- Investigar un tema en varios canales: Ejecute la misma búsqueda en varios canales y compare con qué frecuencia lo menciona cada uno y cuántas vistas lograron esas publicaciones.
Consejos de expertos para la Telegram Channel Search API
- Haga búsquedas separadas para un ticker y para el nombre completo del proyecto, y así cubra las dos formas en que un canal puede escribirlo.
- Las fotos de los resultados enlazan a la publicación que las muestra; envíe la url de esa publicación a Telegram Post Detail API si necesita los archivos de imagen.
- Cada búsqueda abarca un canal; para descubrir más canales sobre un tema, parta de uno conocido con Telegram Similar Channels API.
APIs relacionadas
Además de la Telegram Channel Search API, use estas APIs cuando necesite otro tipo de datos públicos de Telegram.
- Telegram Channel Info API — Consulta hasta 50 canales públicos de Telegram por enlace y obtiene título, descripción, avatar, insignia de verificación y número de suscriptores como entero.
- Telegram Channel Scraper API — Recolecta hasta 1,000 publicaciones de un canal público de Telegram, de la más reciente a la más antigua, con texto, fecha, vistas, reacciones, fotos y videos.
- Telegram Post Detail API — Obtiene hasta 50 publicaciones concretas de Telegram por enlace, de cualquier combinación de canales públicos, con texto completo, fecha, vistas, reacciones y multimedia.
- Telegram Comments API — Recolecta hasta 100 comentarios bajo una publicación de un canal de Telegram desde su grupo de discusión, con autor, texto, fecha, reacciones y comentario respondido.
- Telegram Similar Channels API — Encuentra los canales que Telegram recomienda junto a un canal público, normalmente unos diez, con título, insignia de verificación y número exacto de suscriptores.