{
"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}]}'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Análise de publicações do canal do Telegram API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Analise até 100 mensagens da exportação do seu próprio canal do Telegram: visualizações por inscrito, encaminhamentos, reações, links e hashtags. Sem buscar dados no Telegram. Não afiliado ao Telegram
Envie uma solicitação JSON contendo até 100 objetos de publicações de canais do Telegram exportados do seu próprio canal Cada objeto pode incluir campos como o ID da publicação a data o texto as visualizações os encaminhamentos as reações o nome do canal e o número de inscritos
O endpoint retorna um objeto JSON com uma contagem e um array de itens. Cada item contém informações normalizadas sobre a publicação, metadados de processamento e métricas calculadas, como visualizações, inscritos, encaminhamentos, reações e taxa de atenção.
`postId` identifica a publicação, `date` registra seu carimbo de data e hora, `text` contém a mensagem e `views` registra as visualizações observadas. `found` indica se a publicação foi processada. `stableId` fornece um identificador determinístico para o resultado.
As métricas podem incluir visualizações, encaminhamentos, reações, respostas, inscritos e taxa de atenção. A API também pode identificar links e hashtags no conteúdo das publicações. Uma métrica é retornada como `null` quando a exportação de origem não fornece informações suficientes para calculá-la.
A resposta inclui `views` e `subscribers` no objeto `metrics`. Quando os dados de inscritos estão disponíveis, esses valores podem ser usados para calcular as visualizações por inscrito. Se `subscribers` for `null`, essa comparação não pode ser calculada com segurança
Não O endpoint analisa apenas as mensagens fornecidas na exportação do seu próprio canal do Telegram Ele não busca raspa nem verifica conteúdo pelo Telegram e não é afiliado ao Telegram
A API examina o texto de cada publicação fornecida e identifica links e hashtags para análise de conteúdo. Publicações sem links ou hashtags correspondentes geram resultados vazios em vez de exigir solicitações separadas.
Revise `count`, o valor `found` de cada item e os campos anuláveis antes da análise. A ausência de inscritos, respostas ou taxa de atenção indica dados de origem indisponíveis, não necessariamente atividade zero. Preserve os campos originais da publicação junto às métricas retornadas para fins de auditoria