问答
视频号账号 ID(v2_…@finder)是什么,为什么 sph 开头的视频号 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
- 按名称搜。视频号账号搜索走微信搜一搜,通常只返回名称最匹配的那一个号,带
id、名称、头像和认证主体。存 ID 之前核对一下名称和认证主体。 - 从视频拿。视频号作品详情接受分享链接或视频 ID,返回
author.id。
有了 ID,视频号账号信息给出名称、签名、IP 属地、作品数和关联的公众号,视频号账号作品从新到旧列出作品,每页约 15 条。
| 步骤 | 调用次数 | 费用 |
|---|---|---|
| 名称换 v2_…@finder | 1 | $0.02 |
| 账号信息 | 1 | $0.02 |
| 第一页作品 | 1 | $0.02 |
| 30 个竞品账号,三步都做 | 90 | $1.80 |
示例
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 的话,在微信里打开这个号,分享它的任意一条视频,再用视频去查。
资料来源
- wx.openChannelsUserProfile (微信开放文档): finderUserName is the Channels ID, e.g. sphcqO59YEPCvoe, and where to find it in WeChat
- Request to copy a Channels ID (finderUserName) for opening it from a mini program (wx_channels_download issue #351)
这个问题出现过的地方(读取于 2026-11-12)
更新于