Volver a las API
Datos públicos de canales de Telegram

Telegram Public Data API

Lea canales públicos de Telegram a partir de sus enlaces t.me: perfiles de canal con suscriptores, publicaciones con vistas y reacciones, publicaciones sueltas, comentarios de grupos de discusión, canales similares y búsqueda en todo el historial.

API de Telegram disponibles

Channel Info, Channel Scraper, Similar Channels y Channel Search parten de un enlace de canal; Post Detail y Comments parten de un enlace de publicación, y cada resultado trae enlaces que puede pasar directamente al siguiente endpoint.

¿Qué datos de Telegram se pueden obtener?

Cada endpoint devuelve registros estables de SocQ creados a partir de lo que un canal público muestra a cualquier visitante.

Perfiles de canal

Nombre de usuario, título, descripción, avatar, insignia de verificación y número de suscriptores como entero, hasta 50 canales por solicitud.

Publicaciones y multimedia

Texto, fecha de publicación, vistas, total de reacciones con las reacciones Star de pago incluidas y enlaces de fotos y videos, ya sea hasta 1,000 publicaciones de la más reciente a la más antigua o hasta 50 publicaciones por enlace.

Comentarios de grupos de discusión

Nombre del autor, texto, fecha y reacciones de hasta 100 comentarios por publicación, con parent_id y post_id para reconstruir los hilos de respuestas.

Canales similares

Los canales que Telegram recomienda junto a un canal, normalmente unos diez, en el orden de Telegram y con el número exacto de suscriptores.

Búsqueda dentro de un canal

Hasta 100 publicaciones que contienen una palabra o frase en cualquier punto del historial de un canal, cada una con sus vistas y reacciones.

SocQ y la API de Telegram

La API propia de Telegram está pensada para crear aplicaciones y bots de Telegram. SocQ devuelve los datos de canales públicos como registros normalizados que puede guardar, comparar y combinar.

FuncionalidadSocQAPI de Telegram
AccesoClave de API de SocQID de aplicación de Telegram con una cuenta iniciada, o un token de bot
Entrada inicialEnlaces t.me públicos de canales y publicacionesIdentificadores de objetos de Telegram resueltos dentro de una sesión de cliente
SalidaRegistros JSON normalizados con conteos enterosObjetos nativos de Telegram
FuncionamientoTareas asíncronas con resultados guardados y paginadosLlamadas en vivo desde su propio cliente

Cómo funcionan las API de Telegram

Los seis endpoints siguen el mismo ciclo asíncrono de envío, consulta y lectura.

  1. 1. Partir de un enlace

    Envíe un enlace de canal a Channel Info, Channel Scraper, Similar Channels o Channel Search, o un enlace de publicación a Post Detail o Comments.

  2. 2. Consultar la tarea

    Use el task_id devuelto con /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o falle.

  3. 3. Encadenar los resultados

    Pase las url de publicaciones de Channel Scraper o Channel Search a Comments o Post Detail, y las url de canales de Similar Channels a Channel Info.

Empiece con una sola solicitud a la API

Autentíquese con una clave de API de SocQ. Channel Scraper devuelve 20 publicaciones de forma predeterminada y acepta hasta 1,000.

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}'

# Después, lea los comentarios de una publicación:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# Consulte GET /v1/tasks/{task_id}

Casos de uso frecuentes de la API de Telegram

Evaluación antes de un patrocinio

Revise suscriptores y verificación con Channel Info y las vistas recientes con Channel Scraper antes de pagar por una publicación.

Resúmenes y alertas de canales

Recopile periódicamente las últimas publicaciones de canales de noticias, de mercado o de proyectos y envíe los textos y enlaces nuevos a resúmenes o alertas.

Opiniones de la comunidad

Obtenga los comentarios bajo los anuncios y agrúpelos por tema para ver cómo reaccionan los lectores y qué preguntas se repiten.

Mapa de un nicho

Avance desde canales semilla con Similar Channels para armar una lista de canales relacionados con el tamaño de su audiencia.

Investigación de menciones

Busque una marca, un token o un producto en canales influyentes y mida cuánta atención recibió cada mención.

Alcance de los datos

Los resultados reflejan lo que los canales públicos de Telegram muestran a cualquier visitante en el momento de la recopilación.

  • Todos los endpoints leen canales públicos, identificados por el nombre de usuario del canal o por un número de publicación dentro de un canal.
  • Los comentarios provienen del grupo de discusión que un canal vincula a sus publicaciones, hasta 100 por publicación en cada tarea.
  • Similar Channels devuelve las recomendaciones que Telegram muestra para un canal, que suelen ser unas diez.
  • Channel Search busca dentro de un canal por solicitud, en todo su historial, y devuelve hasta 100 coincidencias.
  • Los conteos son capturas tomadas en collected_at y los enlaces de fotos y videos son temporales, así que descargue pronto los archivos que quiera conservar.

Preguntas frecuentes sobre la API de Telegram

¿Qué es la API de Telegram?

La API de Telegram es un conjunto de endpoints de SocQ que leen canales públicos de Telegram a partir de sus enlaces y devuelven perfiles de canal, publicaciones, comentarios de grupos de discusión, canales similares y resultados de búsqueda dentro de un canal como registros JSON normalizados.

¿Qué API de Telegram están disponibles?

Telegram Channel Info API, Telegram Channel Scraper API, Telegram Post Detail API, Telegram Comments API, Telegram Similar Channels API y Telegram Channel Search API.

¿Necesito una cuenta de Telegram o un token de bot?

No. Las solicitudes usan su clave de API de SocQ y un enlace público de canal o de publicación.

¿Qué formatos de enlace se aceptan?

Enlaces de canal como t.me/durov o t.me/s/durov, sus variantes telegram.me y telegram.dog, y enlaces de publicación como t.me/durov/510 para Post Detail y Comments.

¿Cómo se devuelven los suscriptores y las vistas?

Como números enteros. Las etiquetas abreviadas de Telegram, como 9.95M o 661K, se convierten en enteros, y Similar Channels devuelve el número exacto de suscriptores.

¿Cómo se cobran los endpoints?

Channel Info, Post Detail, Similar Channels y Channel Search cuestan 0.5 créditos por resultado devuelto, y Channel Scraper y Comments cuestan 0.3 créditos por publicación o comentario. Los enlaces que no se pueden leer se omiten o se reembolsan, y las publicaciones sin comentarios y las búsquedas sin coincidencias no cuestan nada.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.