API de plataforma de EveryData

API de Telegram

Q: ¿Cómo llamo a la API de Telegram?

Envía POST /api/v1/social con `platform` igual a `telegram`, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

Q: ¿Qué devuelve la API de Telegram?

Devuelve JSON estructurado. Por ejemplo, el esquema de `channel_posts` incluye `channel_username`, `channel_title`, `text` y `view_count`. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.

Q: ¿Qué parámetros son obligatorios?

Depende de la acción. `channel_posts` requiere `username`; `profile` requiere `username`; `search` requiere `keyword`; consulta las demás acciones en la lista de funciones.

Consulta canales, perfiles, mensajes, grupos y miembros que Telegram expone públicamente. El nombre de usuario identifica el objeto y no amplía sus permisos de visibilidad.

Un contador no equivale a la lista completa de miembros. La API no se une a grupos, lee chats privados, obtiene teléfonos ni envía mensajes.

Empieza gratis Ver el catálogo público

Endpoint: POST /api/v1/social
Funciones: 5
Por 1.000: 0,556 US$

Funciones disponibles

Compara las acciones de Telegram por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

Acción	Obligatorios	Opcionales	Entrega	Límite	Por 1.000	Campos de respuesta
`channel_posts` Leer publicaciones de un canal Lee publicaciones del canal público indicado por `username`, con texto, vistas, fecha y medio cuando existen. No se une al canal ni garantiza todo su historial.	username	—	Entrega síncrona	El catálogo declara `defaultLimit = 20` y `maxLimit = 200` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$0.56 por 1.000 solicitudes	id · url · channel_username · channel_title · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · emoji · count · is_paid
`profile` Consultar un perfil público de Telegram Resuelve un `username` de canal o perfil público y devuelve biografía, verificación y contadores visibles. No accede a chats privados, teléfonos o miembros nominales.	username	—	Entrega síncrona	—	$0.56 por 1.000 solicitudes	username · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform
`search` Buscar mensajes en canales públicos Busca mensajes públicos mediante `keyword` y fechas opcionales, conservando canal, tipo, reacciones y medio. No busca conversaciones privadas ni representa todo Telegram.	keyword	since, until	Entrega síncrona	El catálogo declara `defaultLimit = 20` y `maxLimit = 100` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$0.56 por 1.000 solicitudes	id · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform · emoji · count
`group` Consultar la ficha de un grupo Consulta por `username` la ficha pública de un grupo o canal, con descripción y número de miembros. No solicita ingreso ni concede permisos de lectura restringida.	username	—	Entrega síncrona	—	$0.56 por 1.000 solicitudes	id · type · username · url · title · name · description · member_count · online_count · created_at · is_verified · is_scam · is_fake · is_forum · is_restricted · admin_bots · platform
`members` Enumerar miembros visibles Obtiene miembros visibles del objeto identificado por `username`, con señales públicas de cuenta cuando existen. La lista puede estar limitada y no autoriza contacto masivo.	username	—	Entrega síncrona	El catálogo declara `defaultLimit = 100` y `maxLimit = 5000` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$0.56 por 1.000 solicitudes	id · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · platform

¿Qué acepta cada acción de Telegram?

Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.

Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.

¿Qué significan los parámetros de Telegram `channel_posts`?

Lee publicaciones del canal público indicado por username, con texto, vistas, fecha y medio cuando existen. No se une al canal ni garantiza todo su historial.

usernameObligatorio: Nombre de usuario de un canal o grupo público. Puede ser name, @name, t.me/name o t.me/s/name. Usa channel_posts o profile para canales públicos, group para leer información de entidades públicas y members para obtener los miembros visibles de un grupo. Esta API no admite enlaces de invitación privados ni garantiza una lista completa de miembros.
Telegram: canales públicos, privados y recuentos de vistasTelegram diferencia canales públicos de canales privados por invitación y explica que el recuento de vistas es aproximado e incluye copias reenviadas. No prueba acceso a contenido privado ni a todo el historial del canal.Consultada 2026-09-04
Telegram: la lectura de contenido también debe cumplir las condiciones de la licenciaLa excepción limitada para clientes de terceros, bots y Mini Apps solo cubre los datos estrictamente necesarios para su funcionamiento y está sujeta a los términos, derechos de autor y requisitos de privacidad. La existencia de una API no implica que se haya obtenido una licencia para recopilar, revender o reutilizar los datos libremente.Consultada 2026-09-04

¿Qué significan los parámetros de Telegram `profile`?

Resuelve un username de canal o perfil público y devuelve biografía, verificación y contadores visibles. No accede a chats privados, teléfonos o miembros nominales.

usernameObligatorio: Nombre de usuario de un canal o grupo público. Puede ser name, @name, t.me/name o t.me/s/name. Usa channel_posts o profile para canales públicos, group para leer información de entidades públicas y members para obtener los miembros visibles de un grupo. Esta API no admite enlaces de invitación privados ni garantiza una lista completa de miembros.
Telegram: canales públicos, privados y recuentos de vistasTelegram diferencia canales públicos de canales privados por invitación y explica que el recuento de vistas es aproximado e incluye copias reenviadas. No prueba acceso a contenido privado ni a todo el historial del canal.Consultada 2026-09-04

¿Qué significan los parámetros de Telegram `search`?

Busca mensajes públicos mediante keyword y fechas opcionales, conservando canal, tipo, reacciones y medio. No busca conversaciones privadas ni representa todo Telegram.

keywordObligatorio: Palabra clave para buscar mensajes en canales públicos con search. No busca contactos ni contenido de chats privados.
Telegram: licencia de contenido y restricciones de uso para IALos términos restringen el acceso a contenido más allá de su uso normal previsto y prohíben específicamente la recopilación o agregación de datos de la plataforma para entrenamiento, validación, mejora, evaluación o despliegue de IA. Las excepciones requieren el consentimiento explícito, continuo e individual del usuario para cada contenido y contexto. La visibilidad pública no constituye una licencia de uso universal.Consultada 2026-09-04
sinceOpcional: Límite inferior de la fecha del mensaje para search, corresponde a afterDate. No es la fecha de creación del grupo. La ruta principal de channel_posts no ofrece un filtro de fecha equivalente.
untilOpcional: Límite superior de la fecha del mensaje para search, corresponde a beforeDate. Úsalo con since para acotar el rango de mensajes públicos, pero no se garantiza que se obtengan todos los mensajes dentro del rango.

¿Qué significan los parámetros de Telegram `group`?

Consulta por username la ficha pública de un grupo o canal, con descripción y número de miembros. No solicita ingreso ni concede permisos de lectura restringida.

usernameObligatorio: Nombre de usuario de un canal o grupo público. Puede ser name, @name, t.me/name o t.me/s/name. Usa channel_posts o profile para canales públicos, group para leer información de entidades públicas y members para obtener los miembros visibles de un grupo. Esta API no admite enlaces de invitación privados ni garantiza una lista completa de miembros.
Telegram: grupos, nombres de usuario y privacidad de la última conexiónLa documentación oficial explica los nombres de usuario públicos y los enlaces `t.me`, y aclara que la última conexión puede ocultarse o mostrarse de forma aproximada. El campo `last_seen_at` de los miembros no permite reconstruir un seguimiento preciso, y el nombre de usuario no equivale a un número de teléfono público.Consultada 2026-09-04

¿Qué significan los parámetros de Telegram `members`?

Obtiene miembros visibles del objeto identificado por username, con señales públicas de cuenta cuando existen. La lista puede estar limitada y no autoriza contacto masivo.

usernameObligatorio: Nombre de usuario de un canal o grupo público. Puede ser name, @name, t.me/name o t.me/s/name. Usa channel_posts o profile para canales públicos, group para leer información de entidades públicas y members para obtener los miembros visibles de un grupo. Esta API no admite enlaces de invitación privados ni garantiza una lista completa de miembros.
Telegram: grupos, nombres de usuario y privacidad de la última conexiónLa documentación oficial explica los nombres de usuario públicos y los enlaces `t.me`, y aclara que la última conexión puede ocultarse o mostrarse de forma aproximada. El campo `last_seen_at` de los miembros no permite reconstruir un seguimiento preciso, y el nombre de usuario no equivale a un número de teléfono público.Consultada 2026-09-04
Telegram: la lectura de contenido también debe cumplir las condiciones de la licenciaLa excepción limitada para clientes de terceros, bots y Mini Apps solo cubre los datos estrictamente necesarios para su funcionamiento y está sujeta a los términos, derechos de autor y requisitos de privacidad. La existencia de una API no implica que se haya obtenido una licencia para recopilar, revender o reutilizar los datos libremente.Consultada 2026-09-04

Cómo usar la API de Telegram

01Consulta el catálogo público y elige una acción de la plataforma.
02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
04Guarda los campos de la respuesta estructurada que necesita tu aplicación.

telegram_channel_posts.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"telegram","action":"channel_posts","params":{"username":"<username>"}}'

Preguntas sobre la API de Telegram

¿Cómo llamo a la API de Telegram?

Envía POST /api/v1/social con platform igual a telegram, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

¿Qué devuelve la API de Telegram?

Devuelve JSON estructurado. Por ejemplo, el esquema de channel_posts incluye channel_username, channel_title, text y view_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.

¿Qué matiz de la documentación oficial conviene conservar al usar datos de Telegram?

Telegram diferencia canales públicos de canales privados por invitación y explica que el recuento de vistas es aproximado e incluye copias reenviadas. No prueba acceso a contenido privado ni a todo el historial del canal.

¿Qué parámetros son obligatorios?

Depende de la acción. channel_posts requiere username; profile requiere username; search requiere keyword; consulta las demás acciones en la lista de funciones.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API Ver el catálogo público →