> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 拿到B站视频链接后，BV号、av号和UP主mid分别怎么用？

> 从公开视频链接识别视频目标，区分BV、AV与UP主mid，并直接准备评论请求，避免多做不必要的编号转换。

查 B 站视频评论时，从视频长链接的 `/video/` 后面取 BV 号或 AV 号，作为 `bv_id` 或 `av_id` 传给 `bilibili.app.fetch_video_comments`。Web 评论动作 `bilibili.web.fetch_video_comments` 只接受 BV 号。`space.bilibili.com/` 空间链接里的 UP 主 `mid` 标识的是账号，不是视频，不能用来查评论。两种视频编号之间不需要先查详情做转换。

## 手里这串编号，指向什么？

| 信息                               | 指向的对象         | 这里怎么处理                        |
| -------------------------------- | ------------- | ----------------------------- |
| `BV…`                            | 一条视频          | 保留大小写，App评论用 `bv_id`          |
| 老链接里的 `av…`                      | 一条视频          | 去掉明确的av前缀，App评论用数字字符串 `av_id` |
| `space.bilibili.com/…` 后面的 `mid` | UP主或用户        | 用于账号研究，不能当成视频编号               |
| 返回的评论编号                          | 一条评论          | 后续查回复时使用，与视频编号分别保存            |
| `b23.tv` 短链接                     | 需要确认跳转目标的分享入口 | 先取得目标视频长链接；下方本地准备器不联网展开短链     |

AV 号、`mid` 和评论编号都可能是一串数字。每个编号都和它来自的链接或响应一起保存，不要互相替换。长数字按文本保存，表格里也保持文本格式。

## 已有BV号，可以直接读评论吗？

可以。把 BV 号作为 `bv_id` 传给 `data:bilibili.app.fetch_video_comments`，不需要先买详情做编号转换。`data:bilibili.app.fetch_video_comments` 也接受已确认的 `av_id`，两者传一种；`data:bilibili.web.fetch_video_comments` 当前只声明 BV 输入。

下方准备器 `prepare_bilibili_comments.py` 把明确的 BV 号、AV 号或视频长链接写成 `request.json`，请求时间排序的评论首页。最新与热门怎么选，见[评论排序](/zh/faq/bilibili-comment-order)。

## 从明确的 ID 或长链接准备一页最新评论请求

把下面的脚本保存为 `prepare_bilibili_comments.py`。脚本支持 `bv`、`av`、`url` 三种输入模式。脚本里的正则只检查语法，不证明视频存在。`url` 模式只接受 `bilibili.com` 或 `www.bilibili.com` 上的 HTTPS `/video/` 长链接，拒绝空间链接、直播间链接、短链接、带用户信息的链接和身份查询参数冲突的链接。普通追踪参数和片段不会进入 API 请求。

```python
import json
import pathlib
import re
import sys
from urllib.parse import urlsplit, parse_qs

kind, value, destination = sys.argv[1:4]
bv = r"BV[0-9A-Za-z]{10}"
av = r"[1-9][0-9]*"
source_kind = kind
ignored_query = False
if kind == "url":
    if any(c.isspace() or ord(c) < 32 or ord(c) == 127 for c in value):
        raise ValueError("Use an intact public URL")
    u = urlsplit(value)
    if u.scheme != "https" or u.hostname not in {"bilibili.com", "www.bilibili.com"} or u.username is not None or u.password is not None or u.port not in (None, 443):
        raise ValueError("Use a public HTTPS bilibili.com video URL; resolve short links separately")
    match = re.fullmatch(r"/video/(" + bv + r"|av" + av + r")/?", u.path)
    if not match:
        raise ValueError("Expected a video URL, not an account, live room or short link")
    if any(k.lower() in {"bvid", "bv_id", "aid", "av_id", "mid", "oid"} for k in parse_qs(u.query, keep_blank_values=True)):
        raise ValueError("Ambiguous identity query; copy an unambiguous public video URL")
    value = match[1]
    kind = "bv" if value.startswith("BV") else "av"
    if kind == "av":
        value = value[2:]
    ignored_query = bool(u.query or u.fragment)
if kind not in {"bv", "av"} or not re.fullmatch(bv if kind == "bv" else av, value):
    raise ValueError("Use explicit bv or av text; do not pass mid, a whole URL as an ID or a numeric conversion")
request = {"action": "bilibili.app.fetch_video_comments", "params": {kind + "_id": value, "mode": 2, "next_offset": 1}}
audit = {"input_kind": source_kind, "id_type": kind, "id_text": value, "query_or_fragment_discarded": ignored_query, "executed": False, "identity_scope": "syntax and URL shape only; existence and target not independently verified"}
target = pathlib.Path(destination)
target.mkdir(parents=False, exist_ok=False)
(target / "request.json").write_text(json.dumps(request, ensure_ascii=False, indent=2), encoding="utf-8")
(target / "input-audit.json").write_text(json.dumps(audit, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps({"prepared": True, "executed": False, "id_type": kind}))
```

同一个视频只运行下面三条命令中的一条：

```bash
python3 prepare_bilibili_comments.py bv BV18SCrBGE9E comments-bv
python3 prepare_bilibili_comments.py av 115568241811221 comments-av
python3 prepare_bilibili_comments.py url 'https://www.bilibili.com/video/BV18SCrBGE9E/?p=2' comments-link
```

脚本只写 `request.json` 和 `input-audit.json`，不联网。`request.json` 里 `mode=2` 表示时间排序，`next_offset=1` 表示首页；准备好的请求不会自动翻页，也不保证全历史顺序。脚本会丢弃链接里的 `p` 分 P 参数，因为 `bilibili.app.fetch_video_comments` 没有分 P 输入，所以不要把结果称为该分 P 独有的评论。

## 核对目标和预算后再发送

1. 打开 `request.json`，确认请求里只有一个 `bv_id` 或 `av_id`，且值与原始目标文本一致。数字 AV 号不是 UP 主 `mid`。
2. 只拿到一串来源不明的数字时就停下，不要靠多次付费请求试错判断类型。
3. 每次运行换一个新的输出目录；目录已存在时脚本会拒绝写入。
4. 需要热门排序时，先用 Inspect 查看 `mode` 的真实含义，再有意识地把 `mode` 改为 3。不要把同一个结果同时称为最新评论和热评排名。

当前请求单价见[价格页](https://beatapi.io/zh/pricing)。BV 号或 AV 号已经明确时，直接发送评论请求；视频详情、更多页和回复只在任务需要时再取，费用另计。

```bash
curl --fail-with-body -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @comments-bv/request.json \
  -D comments-bv/response.headers -o comments-bv/response.json
```

用了其他目录时，相应替换请求和响应路径，不要重复运行覆盖上次响应。进行下一步前，先核对 HTTP 状态、公开错误和 `request_id`；HTTP 200 本身不代表响应里有可用评论。`bilibili.app.fetch_video_comments` 目前没有公布可核验的评论列表、回复和游标输出路径，所以 `request.json` 只是请求文件，不是评论 CSV。请求失败就保留失败记录，不要统计成零评论。

来源：App 与 Web 评论输入合同。`prepare_bilibili_comments.py` 的本地测试覆盖 BV 大小写、长数字 AV 原字符串、BV 与 AV 长链接，拒绝 `mid`、短链接、伪域名和身份查询参数，以及已有目录保护和零网络调用。

[只有 AV 号](/zh/faq/bilibili-av-comments) · [App 翻页](/zh/faq/bilibili-app-pagination) · [B 站问题](/zh/faq/bilibili)