# 怎么批量导出视频号视频的评论和回复

> 按关键词搜视频号视频，把搜索结果的加密 ID 换成作品 ID，再把评论和评论下的回复拉进一张表：步骤、参数、Python 代码和花费。

网页版：https://okdata.online/zh/guides/wechat-channels-video-comments/

按顺序用四个接口：视频号视频搜索、作品详情（把搜索结果里 export/ 开头的 ID 换成数字作品 ID）、作品评论、评论回复。下面的示例一共 14 次调用，花费 $0.24；失败的调用不扣费。

更新于 2026-11-12

要做的事：某个产品或话题在视频号上有人在聊，你想看的是观众在视频下面写了什么，而不只是博主自己说了什么。视频号的视频没有网页，评论也没有公开的入口，平时只能拿着手机在 App 里一条条翻。这里的做法是：先搜索，把要留的视频逐个查一次详情，然后一页页读评论，再把值得看的评论展开看回复。最后得到一张表，评论和回复都在里面，每条带内容、昵称、点赞数、时间，以及微信在评论旁边显示的 IP 属地。

有个地方很容易卡住：搜索结果和评论接口用的不是同一种 ID。搜索给的是 `export/` 开头的加密 ID，评论接口要的是数字作品 ID。作品详情接口负责把前者换成后者，所以下面的流程里它夹在搜索和评论之间。

## 分步操作

### 第一步：搜视频

调用[视频号视频搜索](https://okdata.online/zh/apis/wechat_channels/videos/search/)，`query` 填你会在微信“搜一搜”里输入的词。`sort` 可选 `relevance`（默认，综合）、`latest`（最新）或 `popular`（最热）；只想要近期视频的话，`published_within` 可以填 `day`、`week` 或 `half_year`。一次调用最多返回约 10 条视频，每次 $0.02。

```bash
curl -G "https://api.okdata.online/v1/wechat_channels/videos/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=露营装备' \
  --data-urlencode 'sort=popular' \
  --data-urlencode 'published_within=half_year'
```

每条结果有描述 `text`、发布时间 `published_at`、`author` 下的账号名称和头像、`metrics.likes`，`url` 是封面图。这一步评论数是 null，`author.id` 也是空的，因为微信搜一搜本身不给这些。`id` 长这样：`export/UzFfBgAAigSMv7F8h8d7wY6qhwxyunx6wtIhB9zjKomRhS82ch`。它会过期，所以要在同一次运行里接着用，别存起来下周再查。

### 第二步：逐个查作品详情

把 `export/` 开头的 ID 作为 `id` 传给[视频号作品详情](https://okdata.online/zh/apis/wechat_channels/videos/get/)，每次 $0.02。手上是 App 里复制的分享链接也行，写成 `url=https://weixin.qq.com/sph/AqR7tLm2Kd`。返回里有数字作品 `id`（比如 `14987320651142873906`）、`author.id` 里的账号 ID，以及 `metrics.likes`、`metrics.comments`、`metrics.shares` 和 `metrics.favorites`。到这一步才知道哪些视频的评论多到值得读。数字 ID 不会过期，留着它。

```bash
curl -G "https://api.okdata.online/v1/wechat_channels/videos/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=export/UzFfBgAAigSMv7F8h8d7wY6qhwxyunx6wtIhB9zjKomRhS82ch' \
  --data-urlencode 'fields=id,text,author.id,author.name,metrics'
```

### 第三步：读评论

[视频号作品评论](https://okdata.online/zh/apis/wechat_channels/videos/comments/list/)的 `id` 填数字作品 ID。每页约 25 条一级评论，按热度排，每次 $0.015。每条有 `id`、`text`、`author.name`、`likes`、`replies`、`published_at` 和 `ip_location`。要下一页，就把 `page.next_cursor` 原样作为 `cursor` 传回去；`page.has_more` 为 `false` 时停下。

```bash
curl -G "https://api.okdata.online/v1/wechat_channels/videos/comments/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=14987320651142873906'
```

### 第四步：展开回复

[视频号评论回复](https://okdata.online/zh/apis/wechat_channels/comments/replies/list/)要两个 ID：`id` 是一级评论的 ID，`post_id` 是这条评论所在视频的数字 ID。每页约 20 条回复，每次 $0.015，每条回复的 `parent_id` 就是它回复的那条评论。

```bash
curl -G "https://api.okdata.online/v1/wechat_channels/comments/replies/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=14987411208833651275' \
  --data-urlencode 'post_id=14987320651142873906'
```

### 第五步：用 Python 串起来

下面的脚本把四步跑完，写成一个 CSV，`level` 列标明这一行是评论还是回复。`MAX_PAGES` 控制每条视频读几页评论，也就控制了花费上限。

```python
import csv
import os
import requests

API = "https://api.okdata.online"
HEADERS = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
MAX_PAGES = 1   # 每条视频读几页评论；每页一次调用
VIDEOS = 5      # 读几条视频
THREADS = 3     # 一共展开几条评论的回复


def get(path, **params):
    body = requests.get(API + path, headers=HEADERS, params=params, timeout=60).json()
    if body["code"] == "not_found":
        return None  # 已删除或不公开：不扣费
    if body["code"] != "ok":
        raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})")
    return body


hits = get("/v1/wechat_channels/videos/search", query="露营装备", sort="popular")["data"]["items"]
hits = sorted(hits, key=lambda h: h["metrics"]["likes"] or 0, reverse=True)[:VIDEOS]

videos = []
for h in hits:
    body = get("/v1/wechat_channels/videos/get", id=h["id"])  # export/... 换成数字 ID
    if body:
        videos.append(body["data"]["item"])

rows, top = [], []
for v in videos:
    cursor = None
    for _ in range(MAX_PAGES):
        body = get("/v1/wechat_channels/videos/comments/list", id=v["id"], **({"cursor": cursor} if cursor else {}))
        if not body:
            break
        for c in body["data"]["items"]:
            rows.append([v["id"], "comment", c["id"], c["text"], c["author"]["name"], c["likes"], c["ip_location"], c["published_at"]])
            top.append((c["likes"] or 0, c["id"], v["id"]))
        if not body["page"]["has_more"]:
            break
        cursor = body["page"]["next_cursor"]

for _, comment_id, video_id in sorted(top, reverse=True)[:THREADS]:
    body = get("/v1/wechat_channels/comments/replies/list", id=comment_id, post_id=video_id)
    for r in (body["data"]["items"] if body else []):
        rows.append([video_id, "reply", r["id"], r["text"], r["author"]["name"], r["likes"], r["ip_location"], r["published_at"]])

with open("channels_comments.csv", "w", newline="", encoding="utf-8-sig") as f:
    out = csv.writer(f)
    out.writerow(["video_id", "level", "id", "text", "user", "likes", "ip_location", "published_at"])
    out.writerows(rows)
```

按默认值跑，就是 1 次搜索、5 次详情、5 页评论、3 页回复，也就是上面的示例。每条视频读 3 页评论的话，要多 10 次评论调用，再加 $0.15。

## 注意事项

- **搜索 ID 会过期。** `export/` 开头的 ID 只在一小段时间内有效。拿到后马上用作品详情换成数字 `id`，存数字 ID。
- **回复数可能缺失。** 微信不一定返回回复数，所以 `replies` 可能是 null。脚本因此按点赞挑要展开的评论；没有回复的评论只会拿到一个空页。
- **没有播放量。** 视频号不公开播放次数，`metrics.views` 是 null，`meta.unavailable` 里标的原因是 `platform`。
- **评论者 ID。** 评论者是视频号账号时，`author.id` 以 `@finder` 结尾；有些以 `@stranger` 结尾，账号类接口不认这种 ID。
- **排序。** 评论按热度返回，没有按最新排的选项。时间重要的话，自己按 `published_at` 排。
- **重试和失效视频。** 每次调用带一个 `Idempotency-Key` 请求头：24 小时内同样的请求配同样的 key，会拿回上次存下的结果，`meta.replayed` 为 `true`，不再扣费。搜索之后被删掉的视频返回 `not_found`，不扣费。

如果要盯的是某个账号而不是关键词，第一步换成[视频号账号作品](https://okdata.online/zh/apis/wechat_channels/users/videos/list/)。想把多个平台的评论整理成结论，可以看[口碑分析](https://okdata.online/zh/solutions/word-of-mouth/)。

## 示例花费

搜一页“露营装备”，取 5 条视频的详情和各自第一页评论，再展开点赞最多的 3 条评论下的回复

| 接口 | 调用次数 | 单价 | 小计 |
|---|---|---|---|
| [视频号视频搜索](https://okdata.online/zh/apis/wechat_channels/videos/search/) | 1 | $0.02 | $0.02 |
| [视频号作品详情](https://okdata.online/zh/apis/wechat_channels/videos/get/) | 5 | $0.02 | $0.10 |
| [视频号作品评论](https://okdata.online/zh/apis/wechat_channels/videos/comments/list/) | 5 | $0.015 | $0.075 |
| [视频号评论回复](https://okdata.online/zh/apis/wechat_channels/comments/replies/list/) | 3 | $0.015 | $0.045 |
| 合计 | 14 |  | $0.24 |

按本页生成时的价格计算。失败的调用不扣费。

## 在你的 AI 里用（MCP）

先接好 MCP 服务，然后直接说你要什么。智能体会自己找到这些接口、看清价格，再用你的余额调用。

可以这样说：在视频号搜“露营装备”，挑点赞最多的 5 条视频查详情，各取第一页评论，再展开点赞最多的 3 条评论下的回复，整理成一张表：视频、评论或回复、点赞、IP 属地、时间。

```json
{
  "endpoint": "wechat_channels.videos.search",
  "params": {
    "query": "露营装备推荐"
  },
  "idempotency_key": "<新的 UUID>"
}
```

MCP：`https://api.okdata.online/mcp`

## 本指南用到的接口

- [视频号视频搜索](https://okdata.online/zh/apis/wechat_channels/videos/search/) `wechat_channels.videos.search`：$0.02/次 · 每页约 10 条视频
- [视频号作品详情](https://okdata.online/zh/apis/wechat_channels/videos/get/) `wechat_channels.videos.get`：$0.02/次
- [视频号作品评论](https://okdata.online/zh/apis/wechat_channels/videos/comments/list/) `wechat_channels.videos.comments.list`：$0.015/次 · 每页约 25 条评论
- [视频号评论回复](https://okdata.online/zh/apis/wechat_channels/comments/replies/list/) `wechat_channels.comments.replies.list`：$0.015/次 · 每页约 20 条评论

## 更多微信视频号内容

- [微信视频号 API](https://okdata.online/zh/apis/wechat_channels/)
- [视频号 API Python 教程：搜索、作品、账号和评论（2026）](https://okdata.online/zh/guides/wechat-channels-api-python/)
- [怎么拉取一个视频号账号发布的全部视频](https://okdata.online/zh/guides/wechat-channels-user-videos/)
- [视频号账号 ID（v2_…@finder）是什么，为什么 sph 开头的视频号 ID 用不了？](https://okdata.online/zh/answers/wechat-channels-finder-id/)
- [评论接口](https://okdata.online/zh/roles/posts-comments-list/)
- [评论回复接口](https://okdata.online/zh/roles/comments-replies-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)