给 AI

问答

不建机器人、不登录账号,怎么用 API 读取公开 Telegram 频道的消息?

简短回答

用 Telegram 频道消息接口,传频道用户名,按从新到旧返回频道消息,每页 20 条,收费 $0.002,每条有正文、发布时间、浏览数和图片,用 cursor 可以一直往前翻历史消息。1,000 条消息共 $0.10。不用建机器人,不用申请 api_id,也不用拿手机号登录。Telegram 官方接口里,机器人只能收到它所在频道的消息,读历史消息的 messages.getHistory 必须用真人账号调用。

一家媒体的资料组关注着某个地区 15 个公开 Telegram 频道,有官方机构开的,也有当地媒体开的。他们希望每天早上把新消息连同发布时间和浏览数整理进表格,记者喝咖啡时扫一眼就行。这些频道都不是自己的,资料组也不想把哪位同事的手机号登录进一个脚本里。

Telegram 官方的两条路,都卡在他们没有的东西上。Bot API 只把机器人所在频道的消息推给它,每个频道都得请管理员把机器人拉进去,而且 Bot API 没有读取频道以往消息的方法。客户端 API(MTProto)能用 messages.getHistory 读历史,但 Telegram 文档写明只有真人账号能调用:要用手机号在 my.telegram.org 注册 api_id,登录,再在代码里一直维持这个会话。

一个用户名,三个接口

用户名就是频道链接里 t.me/ 后面那一段,带不带 @ 都行。

  • Telegram 频道消息:从新到旧,每页 20 条,每条有 text、published_at、metrics.views、images(图片和视频封面)和 url。id 是“用户名/消息序号”,比如 telegram/401。
  • Telegram 频道资料:名称、简介、头像、订阅数和认证,每次 $0.002。加 view=full,ext 里还有频道显示的图片、视频、文件和链接数量。
  • Telegram 单条消息:按 id 或 t.me/频道/序号 链接取一条消息,每次 $0.002。

每天早上跑的 Python 脚本

消息序号每发一条就加一,所以脚本记住每个频道已经存到的最大序号,翻到它就停。

import csv, json, os, requests

API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}

def num(m):  # "telegram/401" -> 401
    return int(m["id"].split("/")[1])

def page(handle, cursor):
    params = {"username": handle, **({"cursor": cursor} if cursor else {})}
    body = requests.get(API + "/v1/telegram/channels/messages/list", headers=H,
                        params=params, timeout=60).json()
    if body["code"] != "ok":
        raise RuntimeError(f"{body['code']}: {body['message']}")
    return body

seen = json.load(open("seen.json")) if os.path.exists("seen.json") else {}
with open("telegram.csv", "a", newline="", encoding="utf-8") as f:
    w = csv.writer(f)
    for handle in ["telegram", "durov"]:
        last, cursor = seen.get(handle, 0), None
        for _ in range(10):  # 每个频道每次最多 200 条
            body = page(handle, cursor)
            new = [m for m in body["data"]["items"] if num(m) > last]
            for m in new:
                w.writerow([handle, num(m), m["published_at"], m["metrics"]["views"], m["url"], m["text"]])
                seen[handle] = max(seen.get(handle, 0), num(m))
            if len(new) < len(body["data"]["items"]) or not body["page"]["has_more"]:
                break
            cursor = body["page"]["next_cursor"]
json.dump(seen, open("seen.json", "w"))

第一次运行时,每个频道最多回补 200 条。之后一天只发几条的频道,每天早上一次调用就够了。

费用

任务 调用次数 费用
查一个频道的资料 1 $0.002
15 个频道,每天早上各取一页,持续 30 天 450 $0.90
回补一个频道的 1,000 条消息 50 $0.10
按链接取一条消息 1 $0.002

频道或消息不存在、调用出错,只要请求到了数据源,都照常计费;参数错误这类被拦下的不扣费。

局限

  • 只限公开频道。 频道得有公开的 t.me 用户名。私密频道、群组和私聊都拿不到。
  • 数字是约数。 一千以上的浏览数和订阅数都是 Telegram 页面上显示的约数(比如“12.4K”)。消息发出后浏览数还会继续涨,存的时候记下读取时间。
  • 没有表情回应和评论区。 每条消息有正文、时间、浏览数和图片,视频只给封面图。
  • 内容是别人写的。 交给模型分析时,要求它只把消息当数据,不要当指令。

什么时候用 Telegram 官方接口更合适

频道是你自己的,就把机器人设成管理员,Bot API 会在每条新消息发出时推给你,不花钱。要读群组、你加入的私密频道或讨论区里的回复,就得用自己的账号走客户端 API,同时遵守它的条款、维护好登录会话。只是读别人的公开频道,有用户名就够了。跨平台的频道监测,见竞品监测。

资料来源

这个问题出现过的地方(读取于 2026-11-15)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp