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.

telegram/channel-info
Perfiles0.5 créditos por resultado

telegram/channel-posts
Publicaciones0.3 créditos por resultado

telegram/post-detail
Publicaciones0.5 créditos por resultado

telegram/post-comments
Comentarios0.3 créditos por resultado

telegram/similar-channels
Perfiles0.5 créditos por resultado

telegram/channel-search
Búsqueda0.5 créditos por resultado
¿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.
| Funcionalidad | SocQ | API de Telegram |
|---|---|---|
| Acceso | Clave de API de SocQ | ID de aplicación de Telegram con una cuenta iniciada, o un token de bot |
| Entrada inicial | Enlaces t.me públicos de canales y publicaciones | Identificadores de objetos de Telegram resueltos dentro de una sesión de cliente |
| Salida | Registros JSON normalizados con conteos enteros | Objetos nativos de Telegram |
| Funcionamiento | Tareas asíncronas con resultados guardados y paginados | Llamadas 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. 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. Consultar la tarea
Use el task_id devuelto con /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o falle.
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.
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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.
Link in Bio API
Convierta el único enlace de la bio de Instagram, TikTok o YouTube de un creador en datos estructurados: nombre visible, bio, avatar, correo de contacto indicado, perfiles sociales vinculados y cada botón de la página con su título y destino.
Creator API
Parta de un perfil de Instagram, TikTok, YouTube, X, Facebook o Threads para encontrar los correos comerciales públicos de un creador, sus cuentas en otras redes o una estimación de edad y género a partir de su foto de perfil.
Google Hotels API
Busque hoteles por destino, abra la ficha completa de cualquier hotel en Google Hotels y obtenga su calendario de precios por noche, todo conectado por un mismo ID de hotel.
Brand Monitoring API
Encuentre las páginas web que mencionan una marca, un producto o un tema, puntúe cada una por sentimiento y emoción, y resuma cómo habla la web de ello.
AI Search API
Siga cómo AI Overviews, ChatGPT y Google AI Mode responden a las preguntas de su mercado: las respuestas que nombran su marca, qué tan visible es y qué dominios y páginas citan.
Instagram API
Consulte o encuentre perfiles públicos y obtenga registros de listas de seguidores, relaciones de seguidos, publicaciones propias, publicaciones que etiquetan un perfil, resultados por hashtag, Reels, transcripciones, comentarios, conteos de cuentas, métricas de interacción y metadatos multimedia con un único flujo asíncrono.