El 2026-11-17, SocQ añadió la plataforma Telegram con seis endpoints para canales públicos de Telegram. En conjunto cubren todo el ciclo de investigación: evaluar un canal, leer su feed, obtener publicaciones concretas, leer la discusión bajo una publicación, encontrar canales relacionados y buscar una palabra en el historial de un canal.
Esta guía indica qué devuelve cada endpoint, qué solicitud acepta, cuánto cuesta y cuándo usarlo. Todos los endpoints funcionan con enlaces públicos de t.me y se ejecutan como tareas asíncronas de SocQ.
Respuesta rápida: envíe el enlace de un canal o de una publicación pública a uno de los seis endpoints
POST /v1/telegram/...conAuthorization: Bearer $SOCQ_API_KEY. Guarde eltask_iddevuelto, consulteGET /v1/tasks/{task_id}hasta questatusseasucceededy lea los registros endata.results.items. Todos los endpoints se cobran por resultado: 0.3 o 0.5 créditos por fila, es decir, $0.0015 o $0.0025 a $0.005 por crédito.
Los seis nuevos endpoints de Telegram
| Endpoint | Qué devuelve | Entrada | Precio |
|---|---|---|---|
| Channel Info | Título, descripción, avatar, insignia de verificación, número de suscriptores | Hasta 50 enlaces de canales | 0.5 créditos ($0.0025) por canal |
| Channel Scraper | Publicaciones de la más reciente a la más antigua, con texto, hora, visualizaciones, total de reacciones, fotos y videos | Un enlace de canal | 0.3 créditos ($0.0015) por publicación |
| Post Detail | Publicaciones concretas con texto completo, hora, visualizaciones, reacciones y multimedia | Hasta 50 enlaces de publicaciones | 0.5 créditos ($0.0025) por publicación |
| Comments | Hasta 100 comentarios del grupo de discusión vinculado, con autor, texto, hora, reacciones y comentario al que responden | Un enlace de publicación | 0.3 créditos ($0.0015) por comentario |
| Similar Channels | Canales que Telegram recomienda junto a un canal, con nombre de usuario, título, insignia y suscriptores | Un enlace de canal | 0.5 créditos ($0.0025) por canal |
| Channel Search | Publicaciones de todo el historial de un canal que coinciden con una palabra o frase | Un enlace de canal + consulta | 0.5 créditos ($0.0025) por publicación coincidente |
Los seis cobran solo por las filas devueltas, sin tarifa base por solicitud.
Telegram Channel Info: evalúe canales de forma masiva
La Telegram Channel Info API consulta canales públicos mediante enlaces t.me/name o t.me/s/name y devuelve una fila por canal: nombre, descripción, avatar, insignia de verificación y número de suscriptores (metrics.followers_count). Úsela para evaluar un canal antes de un patrocinio, actualizar una lista de seguimiento de canales de noticias o de criptomonedas, o enriquecer enlaces de canales recopilados en otros lugares. El archivo de resultados sin procesar también incluye el número de fotos, videos y enlaces que ha compartido cada canal.
curl -X POST "https://api.socq.ai/v1/telegram/channel-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://t.me/durov", "https://t.me/tginfo"]
}'
Envíe hasta 50 enlaces por solicitud. Los enlaces a canales que no son públicos se omiten; la tarea solo falla, con reembolso, cuando no se puede leer ninguno. Consulte la documentación de Channel Info.
Telegram Channel Scraper: lea el feed de un canal
La Telegram Channel Scraper API lee un canal público desde la última publicación hacia atrás. Cada publicación incluye su texto, hora de publicación, número de visualizaciones, el total de sus reacciones con emoji y con Stars, y las fotos y videos adjuntos. Obtenga los últimos días para un resumen diario o aumente el límite para recuperar el historial de un canal.
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
}'
results_limit vale 20 por defecto y acepta de 1 a 1,000. Un canal que no se puede leer falla con reembolso. Consulte la documentación de Channel Scraper.
Telegram Post Detail: actualice publicaciones conocidas
Cuando ya sabe qué publicaciones le interesan, la Telegram Post Detail API toma sus enlaces y devuelve cada una completa: texto, hora de publicación, visualizaciones, total de reacciones, fotos y videos. Se pueden mezclar publicaciones de distintos canales en una misma solicitud, lo que resulta útil para actualizar las cifras de anuncios o publicaciones de campaña que sigue. El archivo de resultados sin procesar conserva el número de reacciones por emoji y la fuente del reenvío.
curl -X POST "https://api.socq.ai/v1/telegram/post-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://t.me/durov/510"]
}'
Envíe hasta 50 enlaces con el formato t.me/channel/post_id. Las publicaciones eliminadas y las de canales privados se omiten. Consulte la documentación de Post Detail.
Telegram Comments: lea la discusión bajo una publicación
Los canales que vinculan un grupo de discusión permiten a los lectores comentar debajo de cada publicación. La Telegram Comments API lee ese hilo para una publicación y devuelve cada comentario con el nombre de su autor, texto, hora, total de reacciones y el comentario al que responde (parent_id). Úsela para ver cómo reaccionó una comunidad a un anuncio o para alimentar con comentarios un flujo de soporte o de investigación.
curl -X POST "https://api.socq.ai/v1/telegram/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/tginfo/4455",
"results_limit": 100
}'
results_limit vale 100 por defecto, que también es el máximo. Solo paga por los comentarios devueltos. Consulte la documentación de Comments.
Telegram Similar Channels: mapee un nicho
Telegram muestra una fila de canales relacionados en cada canal público. La Telegram Similar Channels API devuelve esa lista para un canal, normalmente unos diez, en el orden en que Telegram los muestra, cada uno con nombre de usuario, título, insignia de verificación y número de suscriptores. Empiece por un competidor o por un canal en el que ya se anuncia para ampliar su lista de medios.
curl -X POST "https://api.socq.ai/v1/telegram/similar-channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/durov"
}'
Consulte la documentación de Similar Channels.
Telegram Channel Search: busque en el historial de un canal
La Telegram Channel Search API busca una palabra o frase en todo el historial de un canal público y devuelve las publicaciones coincidentes con texto, fecha, visualizaciones y reacciones. Compruebe si un canal influyente mencionó alguna vez un proyecto o recopile todas las publicaciones que un canal dedicó a un lanzamiento.
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
}'
results_limit vale 20 por defecto y acepta de 1 a 100. Una búsqueda sin coincidencias no cuesta nada. Las fotos de los resultados de búsqueda enlazan a la publicación que las muestra. Consulte la documentación de Channel Search.
Autenticación y flujo de tareas asíncronas
Cada solicitud lleva su clave de API y un tipo de contenido JSON:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cada llamada de envío inicia una tarea en segundo plano:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La respuesta del envío devuelve data.task_id y data.status. Consulte la tarea con la misma clave:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Mientras la tarea está en queued, running o failed, la respuesta contiene solo metadatos de la tarea; en failed, lea error_message. Cuando está en succeeded, la misma respuesta incluye la primera página de registros normalizados en data.results.items. limit vale 50 por defecto y admite hasta 500. Si has_more es true, pase results.next_cursor como cursor para leer la página siguiente. fields acepta hasta 50 campos o rutas con puntos separados por comas cuando quiera una proyección más pequeña.
Un tiempo de espera agotado en el cliente no cancela la tarea, así que retómela con el mismo task_id en lugar de enviarla de nuevo y pagar por un duplicado. Para evitar las consultas periódicas, añada callback_url al cuerpo del envío; SocQ envía un único POST con un resumen de la tarea cuando esta termina, y después usted lee los registros desde el endpoint de tareas.
Cuánto cuesta un trabajo típico
- Evaluar 50 canales con Channel Info: 50 × 0.5 = 25 créditos, $0.125.
- Recuperar 1,000 publicaciones de un canal: 1,000 × 0.3 = 300 créditos, $1.50.
- Leer 100 comentarios bajo un anuncio: 30 créditos, $0.15.
- Buscar en un canal y obtener 20 coincidencias: 10 créditos, $0.05.
Preguntas frecuentes
¿Estos endpoints funcionan con canales o grupos privados?
No. Leen canales públicos a través de sus enlaces t.me. Channel Info y Post Detail omiten los enlaces que no pueden leer, y Comments lee el grupo de discusión que un canal público vincula a sus publicaciones.
¿Hasta dónde puede retroceder Channel Scraper?
Lee de lo más reciente a lo más antiguo, y results_limit acepta hasta 1,000 publicaciones por solicitud. Para encontrar publicaciones más antiguas sobre un tema concreto, use Channel Search, que recorre todo el historial del canal.
¿Qué incluye el número de reacciones?
En las publicaciones de canales, metrics.likes_count contiene el total de reacciones con emoji y con Stars. El archivo de resultados sin procesar de Post Detail conserva el número de reacciones por emoji.
¿Pago por canales o publicaciones que no se encuentran?
No. Se cobra por fila devuelta, sin tarifa base. Una búsqueda con Channel Search sin coincidencias no cuesta nada, y una tarea en la que no se puede leer ninguno de los enlaces falla con reembolso.
¿Cómo encuentro nuevos canales para seguir?
Empiece por un canal que conozca y llame a Similar Channels; luego pase los enlaces devueltos a Channel Info para comparar el número de suscriptores. Vea todos los endpoints en la página de la plataforma Telegram y las tarifas actuales en la página de precios.
TELEGRAM API
Probar el flujo de trabajo con una URL pública de Telegram
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de Telegram