给 AI

问答

视频号账号 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

  1. 按名称搜。视频号账号搜索走微信搜一搜,通常只返回名称最匹配的那一个号,带 id、名称、头像和认证主体。存 ID 之前核对一下名称和认证主体。
  2. 从视频拿。视频号作品详情接受分享链接或视频 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 的话,在微信里打开这个号,分享它的任意一条视频,再用视频去查。

资料来源

  1. wx.openChannelsUserProfile (微信开放文档): finderUserName is the Channels ID, e.g. sphcqO59YEPCvoe, and where to find it in WeChatdevelopers.weixin.qq.com · 读取于
  2. Request to copy a Channels ID (finderUserName) for opening it from a mini program (wx_channels_download issue #351)github.com · 读取于

这个问题出现过的地方(读取于 2026-11-12)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp