{
"count": 2,
"items": [
{
"schemaVersion": "2.0.0",
"recordType": "telegram_export_post_intelligence",
"stableId": "sha256:a6b9936e5432ce4928152b67898cad701e4869bc13eab2172a4386e9f700d804",
"input": "my_owned_channel",
"channel": "my_owned_channel",
"channelTitle": null,
"subscribers": null,
"postId": "101",
"views": "4200",
"date": "2026-08-12T12:00:00.000Z",
"text": "Product update for our subscribers",
"found": true,
"scrapedAt": "2026-11-22T16:56:53.593Z",
"processedAt": "2026-11-22T16:56:53.593Z",
"sourceUrl": null,
"metrics": {
"views": 4200,
"subscribers": null,
"forwards": 31,
"replies": null,
"reactions": 86,
"attentionRate": null
},
"observedAt": "2026-11-22T16:56:53.593Z",
"freshness": {
"status": "stale",
"ageSeconds": 8830613,
"basis": "buyer_supplied_message_date"
},
"change": {
"status": "not_measured",
"basis": "single_buyer_supplied_snapshot"
},
"confidence": {
"level": "MEDIUM",
"basis": [
"record_shape_validated",
"stable_channel_post_identity",
"buyer_authorization_attested"
],
"gaps": [
"subscriber_count_not_supplied",
"source_url_not_supplied",
"single_snapshot_no_change_baseline",
"buyer_supplied_records_not_independently_verified"
]
},
"evidence": [
{
"type": "buyer_supplied_message_record",
"field": "message",
"digest": "sha256:d661cdddbb88c5ef126f590fc789581f143ccfda6ff2e5a86854bc47824e3d14"
},
{
"type": "buyer_authorization_attestation",
"field": "authorization",
"digest": "sha256:394f92e78521ad3b51b02c3368df8efb3538e7319d134618cc93149eb1272f9b"
}
],
"recommendedAction": "Keep the post as baseline evidence; collect a newer authorized export before acting.",
"priority": "LOW",
"safeToAutomate": false,
"summary": "Authorized record my_owned_channel/101; reach context is incomplete.",
"failureDiagnostics": null,
"billing": {
"billingEligible": true,
"billingIntent": "linked_push_result_found",
"eventName": "result-found",
"unit": "one delivered Telegram export post intelligence row",
"settlementSource": "current_run_kvs_output"
},
"requestDigest": "sha256:394f92e78521ad3b51b02c3368df8efb3538e7319d134618cc93149eb1272f9b",
"inputDigest": "sha256:d661cdddbb88c5ef126f590fc789581f143ccfda6ff2e5a86854bc47824e3d14"
},
{
"schemaVersion": "2.0.0",
"recordType": "telegram_export_post_intelligence",
"stableId": "sha256:619f75f00754b409929111719462a61457b6b48dc207f04e0c9912efe1bc8f87",
"input": "my_owned_channel",
"channel": "my_owned_channel",
"channelTitle": null,
"subscribers": null,
"postId": "102",
"views": "2800",
"date": "2026-08-11T12:00:00.000Z",
"text": "Customer question and answer",
"found": true,
"scrapedAt": "2026-11-22T16:56:53.593Z",
"processedAt": "2026-11-22T16:56:53.593Z",
"sourceUrl": null,
"metrics": {
"views": 2800,
"subscribers": null,
"forwards": 12,
"replies": null,
"reactions": 44,
"attentionRate": null
},
"observedAt": "2026-11-22T16:56:53.593Z",
"freshness": {
"status": "stale",
"ageSeconds": 8917013,
"basis": "buyer_supplied_message_date"
},
"change": {
"status": "not_measured",
"basis": "single_buyer_supplied_snapshot"
},
"confidence": {
"level": "MEDIUM",
"basis": [
"record_shape_validated",
"stable_channel_post_identity",
"buyer_authorization_attested"
],
"gaps": [
"subscriber_count_not_supplied",
"source_url_not_supplied",
"single_snapshot_no_change_baseline",
"buyer_supplied_records_not_independently_verified"
]
},
"evidence": [
{
"type": "buyer_supplied_message_record",
"field": "message",
"digest": "sha256:88c3d8e944b2028ee18ba0334564c39d415928ec83889b02ae81d3fa12914a46"
},
{
"type": "buyer_authorization_attestation",
"field": "authorization",
"digest": "sha256:394f92e78521ad3b51b02c3368df8efb3538e7319d134618cc93149eb1272f9b"
}
],
"recommendedAction": "Keep the post as baseline evidence; collect a newer authorized export before acting.",
"priority": "LOW",
"safeToAutomate": false,
"summary": "Authorized record my_owned_channel/102; reach context is incomplete.",
"failureDiagnostics": null,
"billing": {
"billingEligible": true,
"billingIntent": "linked_push_result_found",
"eventName": "result-found",
"unit": "one delivered Telegram export post intelligence row",
"settlementSource": "current_run_kvs_output"
},
"requestDigest": "sha256:394f92e78521ad3b51b02c3368df8efb3538e7319d134618cc93149eb1272f9b",
"inputDigest": "sha256:88c3d8e944b2028ee18ba0334564c39d415928ec83889b02ae81d3fa12914a46"
}
]
}
curl --location --request POST 'https://zylalabs.com/api/15240/telegram+channel+post+analytics+api/40770/analyze+messages' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"schemaVersion":"2.0","authorization":"I confirm I am authorized to process and deliver these records","sourceContext":"telegram_desktop_export","channel":"my_owned_channel","messages":[{"id":101,"date":"2026-08-12T12:00:00Z","text":"Product update for our subscribers","views":4200,"forwards":31,"reactions":86},{"id":102,"date":"2026-08-11T12:00:00Z","text":"Customer question and answer","views":2800,"forwards":12,"reactions":44}]}'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Analíticas de publicaciones del canal de Telegram API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
Analiza hasta 100 mensajes de la exportación de tu propio canal de Telegram: visualizaciones por suscriptor, reenvíos, reacciones, enlaces y hashtags. Sin obtener datos de Telegram. No está afiliado a Telegram
Envía una solicitud JSON que contenga hasta 100 objetos de publicaciones de canales de Telegram de tu propia exportación del canal Cada objeto puede incluir campos como el ID de la publicación la fecha el texto las visualizaciones los reenvíos las reacciones el nombre del canal y el número de suscriptores
El endpoint devuelve un objeto JSON con un recuento y un array de elementos Cada elemento contiene información normalizada de la publicación metadatos de procesamiento y métricas calculadas como visualizaciones suscriptores reenvíos reacciones y tasa de atención
`postId` identifica la publicación `date` registra su marca de tiempo `text` contiene el mensaje y `views` registra las visualizaciones observadas `found` indica si se procesó la publicación `stableId` proporciona un identificador determinista para el resultado
Las métricas pueden incluir visualizaciones, reenvíos, reacciones, respuestas, suscriptores y tasa de atención. La API también puede identificar enlaces y hashtags en el contenido de las publicaciones. Una métrica se devuelve como `null` cuando la exportación de origen no proporciona suficiente información para calcularla. .
La respuesta incluye `views` y `subscribers` en el objeto `metrics` Cuando hay datos de suscriptores disponibles estos valores se pueden usar para calcular las vistas por suscriptor Si `subscribers` es `null` esa comparación no se puede calcular de forma fiable
No. El endpoint analiza únicamente los mensajes incluidos en la exportación de tu propio canal de Telegram. No obtiene, extrae ni verifica contenido a través de Telegram, y no está afiliado a Telegram.
La API examina el texto de cada publicación proporcionada e identifica enlaces y hashtags para analizar el contenido Las publicaciones sin enlaces ni hashtags coincidentes generan resultados vacíos en lugar de requerir solicitudes separadas
Revisa `count`, el valor `found` de cada elemento y los campos que admiten valores nulos antes del análisis. La ausencia de suscriptores, respuestas o tasa de atención indica que los datos de origen no están disponibles, no necesariamente que la actividad sea nula. Conserva los campos originales de la publicación junto con las métricas devueltas para la auditoría