{
"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}]}'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 Telegram频道帖子分析 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
分析你自己的 Telegram 频道导出文件中的最多 100 条消息:每位订阅者的浏览量、转发量、回应、链接和主题标签。不抓取 Telegram 数据。与 Telegram 无关联
发送一个 JSON 请求,其中包含最多 100 个来自你自己的频道导出数据的 Telegram 频道帖子对象。每个对象可以包含帖子 ID、日期、文本、浏览量、转发量、反应数、频道名称和订阅者数量等字段
该端点返回一个包含数量和 items 数组的 JSON 对象 每个项目包含标准化的帖子信息 处理元数据以及计算得出的指标 例如浏览量 订阅者数 转发数 反应数和关注率
`postId` 标识帖子 `date` 记录其时间戳 `text` 包含消息 `views` 记录观察到的浏览量 `found` 表示帖子是否已处理 `stableId` 为结果提供一个确定性标识符
指标可能包括浏览量、转发量、反应数、回复数、订阅者人数和关注率。API 还可以识别帖子内容中的链接和话题标签。如果源导出提供的信息不足以计算某项指标,则该指标将返回为 `null`】【。
响应在 `metrics` 对象中包含 `views` 和 `subscribers`。当订阅者数据可用时,可以使用这些值计算每位订阅者的观看次数。如果 `subscribers` 为 `null`,则无法可靠地计算这一对比。
不 该端点仅分析您自己的 Telegram 频道导出文件中提供的消息 它不会通过 Telegram 获取 抓取或验证内容 并且与 Telegram 无关
该 API 会检查每条提供的帖子的文本,并识别链接和话题标签以进行内容分析。没有匹配链接或话题标签的帖子会返回空结果,而无需单独请求
分析前请检查 `count`、每个项目的 `found` 值以及可为空字段。缺少订阅者数、回复数或关注率表示源数据不可用,并不一定代表活动量为零。为便于审计,请保留原始帖子字段以及返回的指标