# 视频号账号 ID（v2_…@finder）是什么，为什么 sph 开头的视频号 ID 用不了？

> 视频号账号有一个给微信自家功能用的 sph… ID，还有一个数据接口用的内部 ID v2_…@finder。两者各长什么样、为什么互相换不了，以及怎么拿到对的那个。

网页版：https://okdata.online/zh/answers/wechat-channels-finder-id/

**简短回答：**v2_…@finder 是账号在视频号服务里的内部用户名，视频号的数据接口都用它；App 里显示的 sph… 是给微信自家功能用的公开 ID，比如从小程序打开视频号主页，两者之间没有公开的换算方法。okdata 的视频号账号搜索按名称找到 v2_…@finder，每次 $0.02，而且每条视频的 author.id 也是它。

一个视频号账号有两个标识，分别给微信的两边用。能看到的那个叫“视频号ID”：打开微信，我 → 视频号 → 右上角菜单 → 点自己的视频号名字，就能看到，是一串 `sph` 开头的短字符，比如 `sphQ3x9KdLm2Tz`。微信小程序接口打开视频号主页时，`finderUserName` 填的就是它。另一个是内部的：`v2_` 开头，中间一长串十六进制，以 `@finder` 结尾，总共 86 个字符左右。这是账号在视频号服务里的用户名，主页、作品列表、直播回放这些数据都按它来取。把 sph ID 贴进数据工具，什么也查不到，因为两者属于不同的系统，微信也没有公开它们之间的对应关系。

## 怎么区分

| | 视频号ID | 账号用户名 |
|---|---|---|
| 长什么样 | `sphQ3x9KdLm2Tz` | `v2_0600002310…a8f1@finder`（约 86 个字符） |
| 在哪里看到 | 微信里视频号的资料设置 | 数据接口返回、分享链接解析结果 |
| 谁认它 | 微信自家功能（小程序跳转） | 视频号数据接口、okdata |
| 在 okdata 数据里 | 不返回 | 账号的 `id`、视频的 `author.id` |

还有两种字符串长得像，但都不是账号 ID：`weixin.qq.com/sph/AH3sCoIPhH` 这样的分享链接指向的是一条视频；视频 ID 是一长串数字，比如 `15051893554318805499`。

## 怎么拿到 v2_…@finder

1. **按名称搜。**[视频号账号搜索](/zh/apis/wechat_channels/users/search/)走微信搜一搜，通常只返回名称最匹配的那一个号，带 `id`、名称、头像和认证主体。存 ID 之前核对一下名称和认证主体。
2. **从视频拿。**[视频号作品详情](/zh/apis/wechat_channels/videos/get/)接受分享链接或视频 ID，返回 `author.id`。

有了 ID，[视频号账号信息](/zh/apis/wechat_channels/users/get/)给出名称、签名、IP 属地、作品数和关联的公众号，[视频号账号作品](/zh/apis/wechat_channels/users/videos/list/)从新到旧列出作品，每页约 15 条。

| 步骤 | 调用次数 | 费用 |
|---|---|---|
| 名称换 v2_…@finder | 1 | $0.02 |
| 账号信息 | 1 | $0.02 |
| 第一页作品 | 1 | $0.02 |
| 30 个竞品账号，三步都做 | 90 | $1.80 |

## 示例

```bash
curl -G "https://api.okdata.online/v1/wechat_channels/users/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=央视新闻' \
  --data-urlencode 'fields=id,name,ext.verified_by'
```

然后把返回的 `id` 连同 `@finder` 一起，作为 `id` 传给账号信息或作品列表接口。记得做 URL 编码，`@` 不能丢。

## 限制

- 粉丝数和获赞总数经常是 null：很多账号的这两个数微信不公开，`meta.unavailable` 会标为 `platform`。
- 账号的 `url` 是视频号首页，因为微信没有给视频号主页做网页版。
- 搜索按名称找，不按 sph ID 找。手上只有 sph ID 的话，在微信里打开这个号，分享它的任意一条视频，再用视频去查。

## 用到的接口

- [视频号账号搜索](https://okdata.online/zh/apis/wechat_channels/users/search/) `wechat_channels.users.search`：$0.02/次 · 每页约 1 个账号
- [视频号账号信息](https://okdata.online/zh/apis/wechat_channels/users/get/) `wechat_channels.users.get`：$0.02/次
- [视频号账号作品](https://okdata.online/zh/apis/wechat_channels/users/videos/list/) `wechat_channels.users.videos.list`：$0.02/次 · 每页约 15 条视频
- [视频号作品详情](https://okdata.online/zh/apis/wechat_channels/videos/get/) `wechat_channels.videos.get`：$0.02/次

## 更多微信视频号内容

- [微信视频号 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/)
- [怎么批量导出视频号视频的评论和回复](https://okdata.online/zh/guides/wechat-channels-video-comments/)
- [账号信息接口](https://okdata.online/zh/roles/accounts-get/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [账号搜索接口](https://okdata.online/zh/roles/accounts-search/)

## 资料来源

- [wx.openChannelsUserProfile (微信开放文档): finderUserName is the Channels ID, e.g. sphcqO59YEPCvoe, and where to find it in WeChat](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/channels/wx.openChannelsUserProfile.html) (读取于 2026-11-12)
- [Request to copy a Channels ID (finderUserName) for opening it from a mini program (wx_channels_download issue #351)](https://github.com/ltaoo/wx_channels_download/issues/351) (读取于 2026-11-12)

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

- https://github.com/ltaoo/wx_channels_download/issues/351
- https://github.com/NervJS/taro/issues/16214

更新于 2026-11-12