Telegram Channel Info
Telegram Channel Info es el perfil público de un canal de difusión, formado por su nombre de usuario, título, descripción, avatar, insignia de verificación y número de suscriptores. Esas pocas señales muestran qué tan grande es un canal, si Telegram lo verificó y sobre qué dice publicar, lo que sirve para evaluar canales antes de un patrocinio, mantener listas de seguimiento y enriquecer listas de canales.
Funcionalidades de la Telegram Channel Info API
- Hasta 50 canales en una tareaCombine en urls enlaces t.me/name, t.me/s/name, telegram.me y telegram.dog; un canal repetido se consulta una sola vez y cada canal encontrado devuelve una fila.
- Suscriptores como número enterometrics.followers_count convierte la cifra abreviada de Telegram, como 9.95M, en un entero como 9950000, listo para ordenar, filtrar y fijar umbrales.
- Identidad y verificación en una filausername, name, text y avatar_url describen el canal, e is_verified indica si lleva la insignia de verificación de Telegram.
- Enlaces ilegibles omitidos sin costoUn enlace a un canal privado o eliminado queda fuera de los resultados y no cuesta nada, mientras los demás canales del lote se devuelven con normalidad.
Parámetros de la Telegram Channel Info API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Hasta 50 enlaces de canales públicos de Telegram, como https://t.me/durov o https://t.me/s/durov. También funcionan los enlaces telegram.me y telegram.dog, y un canal repetido se consulta una sola vez. |
Cómo usar la Telegram Channel Info API
Envíe una lista de enlaces de canales y lea una fila por cada canal encontrado.
- Envíe {"urls": ["https://t.me/durov", "https://t.me/tginfo"]} por POST a /v1/telegram/channel-info.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea los canales 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-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://t.me/durov","https://t.me/tginfo"]}'Casos de uso de la Telegram Channel Info API
- Evaluar un canal antes de un patrocinio: Revise juntos el número de suscriptores, el estado de verificación y la descripción del canal antes de aceptar una publicación pagada.
- Mantener al día una lista de seguimiento: Vuelva a ejecutar la misma lista periódicamente y guarde followers_count con collected_at para seguir el crecimiento de cada canal de cripto, noticias o nicho.
- Enriquecer enlaces reunidos en otro lugar: Convierta una columna de enlaces t.me de una hoja de cálculo, una búsqueda o una lista de socios en títulos, descripciones y tamaños de audiencia.
Consejos de expertos para la Telegram Channel Info API
- Use el username devuelto como clave: t.me/name y t.me/s/name apuntan al mismo canal y generan el mismo id, así que las consultas repetidas se combinan sin duplicados.
- Un enlace de publicación como https://t.me/durov/510 se lee como su canal; para obtener la publicación en sí, envíelo a Telegram Post Detail API.
APIs relacionadas
Además de la Telegram Channel Info API, use estas APIs cuando necesite otro tipo de datos públicos de Telegram.
- 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.
- Telegram Channel Search API — Busca una palabra o frase en todo el historial de un canal público de Telegram y devuelve hasta 100 publicaciones coincidentes con texto, fecha, vistas y reacciones.