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

> 按用户名读取公开 Telegram 频道的消息：正文、发布时间、浏览数和图片，从新到旧，历史消息也能翻。不用机器人、api_id 和登录会话。价格、Python 代码和局限。

网页版：https://okdata.online/zh/answers/telegram-channel-messages-api/

**简短回答：**用 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 频道消息](/zh/apis/telegram/channels/messages/list/)：从新到旧，每页 20 条，每条有 `text`、`published_at`、`metrics.views`、`images`（图片和视频封面）和 `url`。`id` 是“用户名/消息序号”，比如 `telegram/401`。
- [Telegram 频道资料](/zh/apis/telegram/channels/get/)：名称、简介、头像、订阅数和认证，每次 $0.002。加 `view=full`，`ext` 里还有频道显示的图片、视频、文件和链接数量。
- [Telegram 单条消息](/zh/apis/telegram/messages/get/)：按 `id` 或 `t.me/频道/序号` 链接取一条消息，每次 $0.002。

## 每天早上跑的 Python 脚本

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

```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，同时遵守它的条款、维护好登录会话。只是读别人的公开频道，有用户名就够了。跨平台的频道监测，见[竞品监测](/zh/solutions/competitor-monitoring/)。

## 用到的接口

- [Telegram 频道消息](https://okdata.online/zh/apis/telegram/channels/messages/list/) `telegram.channels.messages.list`：$0.002/次 · 每页约 20 条帖子
- [Telegram 频道资料](https://okdata.online/zh/apis/telegram/channels/get/) `telegram.channels.get`：$0.002/次
- [Telegram 单条消息](https://okdata.online/zh/apis/telegram/messages/get/) `telegram.messages.get`：$0.002/次

## 更多Telegram内容

- [Telegram API](https://okdata.online/zh/apis/telegram/)

## 资料来源

这个问题出现过的地方（读取于 2026-11-15）：

- https://stackoverflow.com/questions/46117493
- https://stackoverflow.com/questions/76754785
- https://stackoverflow.com/questions/41776939

更新于 2026-11-15
