# 视频号账号资料接口 视频号账号资料 API（数据接口）按编号返回一个公开的视频号账号：名称、简介和作品数，返回格式和 SocialToAI 的其他调用相同。每次调用 12 积分（约 $0.024–$0.04），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。最近实测：2026-10-17。 - 页面：https://socialtoai.com/zh/wechat-channels-user-profile-api/ - 最近更新：2026-10-17 - 最近实测：2026-10-17 | 请求 | 价格键 | 积分 | | --- | --- | --- | | `POST /v1/user_profile` | `wechat_channels.user_profile` | 12 | ## 请求 ```bash curl https://api.socialtoai.com/v1/user_profile \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "platform": "wechat_channels", "id": "v2_060000231003b20faec8c5e5811dc3ddce02ec30b0772029a703e1b9f446ba147658bbcfab81@finder" }' ``` ```python import os import requests response = requests.post( "https://api.socialtoai.com/v1/user_profile", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "platform": "wechat_channels", "id": "v2_060000231003b20faec8c5e5811dc3ddce02ec30b0772029a703e1b9f446ba147658bbcfab81@finder", }, ) print(response.json()) ``` ## 参数 | 名称 | 类型 | 是否必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | `platform` | string | 必填 | — | 这一页固定填 "wechat_channels"。 | | `id` | string | 必填 | — | 视频号账号编号，v2_ 开头、@finder 结尾；作品的 author.id 就是它 | ## 参数从哪里来 - `id`：视频号账号编号，v2_ 开头、@finder 结尾；作品的 author.id 就是它（例如 `v2_060000231003b20faec8c5e5811dc3ddce02ec30b0772029a703e1b9f446ba147658bbcfab81@finder`） 平台上没有别的接口返回它。 ## 返回字段 | 字段 | 类型 | 含义 | 能否给出 | | --- | --- | --- | --- | | `items[].username` | string | 账号名。 | 视频号给不了，始终是 null | | `items[].name` | string | 显示名。 | 有 | | `items[].url` | string | 主页链接。 | 视频号给不了，始终是 null | | `items[].bio` | string | 简介。 | 有 | | `items[].verified` | boolean | 是否认证。 | 视频号给不了，始终是 null | | `items[].followers` | integer | 粉丝数。 | 视频号给不了，始终是 null | | `items[].following` | integer | 关注数。 | 视频号给不了，始终是 null | | `items[].posts_count` | integer | 发布的内容数。 | 有 | 每一条另有 platform、id、ref、approx、type；items 外面的部分每个调用都一样。 [返回格式](https://socialtoai.com/zh/docs/api/response.md) ## 示例返回 示例数据：名称、链接和正文已替换成占位符，数字是录制时的真实值。 ```json { "request_id": "req_00000000-0000-4000-8000-000000000001", "schema_version": "v1", "fetched_at": "2026-10-12T19:03:55.000Z", "action": "user_profile", "platform": "wechat_channels", "status": "ok", "items": [ { "platform": "wechat_channels", "id": "…", "ref": "…", "approx": [], "type": "account", "username": null, "name": "…", "url": null, "bio": "…", "verified": null, "followers": null, "following": null, "posts_count": 12415 } ], "unavailable": ["username", "url", "verified", "followers", "following"], "warnings": [], "applied_params": { "id": "v2_060000231003b20faec8c5e5811dc3ddce02ec30b0772029a703e1b9f446ba147658bbcfab81@finder" }, "cost_credits": 12, "billing": { "cost_credits": 12, "balance_credits": 88, "today_spend_credits": 12, "daily_limit_credits": null, "daily_remaining_credits": null, "display": "本次 12 积分，余额 88 积分" }, "replayed": false } ``` ## 翻页与失败 - 一次调用返回一个对象，不翻页，12 积分。 - 每把 Key 每秒 1 次，购买后 5 次；超出不扣费。 [频率限制](https://socialtoai.com/zh/docs/credits-and-billing.md#rate-limits) - 失败的调用 0 积分，不会自动重试。 [错误码](https://socialtoai.com/zh/docs/api/errors.md) ## 在 AI 里这样问 - 查一下这个视频号账号：v2_060000231003b20faec8c5e5811dc3ddce02ec30b0772029a703e1b9f446ba147658bbcfab81@finder → `user_profile {"platform":"wechat_channels","id":"v2_060000231003b20faec8c5e5811dc3ddce02ec30b0772029a703e1b9f446ba147658bbcfab81@finder"}`，12 积分 ## 用到它的现成工具 - [账号监测](https://socialtoai.com/zh/tools/account-watch.md)：每个账号最近发了什么，哪条明显好于平时 - [达人档案](https://socialtoai.com/zh/tools/creator-card.md)：这个人在其他平台的账号、各自的数据，以及是同一人的把握 - [批量链接数据](https://socialtoai.com/zh/tools/batch-stats.md)：每条链接一行，给出现在的数字；失效的链接会标出来 ## 同一个调用在其他平台 | 平台 | 价格键 | 积分 | 页面 | | --- | --- | --- | --- | | TikTok | `tiktok.user_profile` | 2 | https://socialtoai.com/zh/tiktok-user-profile-api.md | | Instagram | `instagram.user_profile` | 2 | https://socialtoai.com/zh/instagram-user-profile-api.md | | X | `x.user_profile` | 1 | https://socialtoai.com/zh/x-user-profile-api.md | | Reddit | `reddit.user_profile` | 2 | https://socialtoai.com/zh/reddit-user-profile-api.md | | YouTube | `youtube.user_profile` | 2 | https://socialtoai.com/zh/youtube-user-profile-api.md | | Facebook | `facebook.user_profile` | 2 | https://socialtoai.com/zh/facebook-user-profile-api.md | | LinkedIn | `linkedin.user_profile` | 2 | https://socialtoai.com/zh/linkedin-user-profile-api.md | | Threads | `threads.user_profile` | 2 | https://socialtoai.com/zh/threads-user-profile-api.md | | Telegram | `telegram.user_profile` | 2 | https://socialtoai.com/zh/telegram-user-profile-api.md | | 小红书 | `xiaohongshu.user_profile` | 12 | https://socialtoai.com/zh/xiaohongshu-user-profile-api.md | | 抖音 | `douyin.user_profile` | 2 | https://socialtoai.com/zh/douyin-user-profile-api.md | | 微博 | `weibo.user_profile` | 2 | https://socialtoai.com/zh/weibo-user-profile-api.md | | 公众号 | `wechat.user_profile` | 12 | https://socialtoai.com/zh/wechat-user-profile-api.md | | B 站 | `bilibili.user_profile` | 2 | https://socialtoai.com/zh/bilibili-user-profile-api.md | | 知乎 | `zhihu.user_profile` | 2 | https://socialtoai.com/zh/zhihu-user-profile-api.md | | 快手 | `kuaishou.user_profile` | 12 | https://socialtoai.com/zh/kuaishou-user-profile-api.md | ## 视频号的其他接口 | 接口 | 做什么 | 价格键 | 积分 | 页面 | | --- | --- | --- | --- | --- | | `search` | 按关键词找视频：正文、作者、点赞数和发布时间。 | `wechat_channels.search` | 12 | https://socialtoai.com/zh/wechat-channels-search-api.md | | `detail` | 用编号取一条视频：正文、作者、点赞数、评论数和发布时间。 | `wechat_channels.detail` | 12 | https://socialtoai.com/zh/wechat-channels-detail-api.md | | `comments` | 一条视频下的评论：正文、点赞数和时间。 | `wechat_channels.comments` | 12 | https://socialtoai.com/zh/wechat-channels-comments-api.md | | `user_posts` | 一个账号最近发布的视频。 | `wechat_channels.user_posts` | 12 | https://socialtoai.com/zh/wechat-channels-user-posts-api.md | | `collections` | 按视频号账号编号取这个账号公开的全部合集。 | `wechat_channels.collections` | 12 | https://socialtoai.com/zh/wechat-channels-collections-api.md | | `collection_videos` | 按合集编号取一页视频号合集里的视频，按合集自己的顺序（从最早的开始），每页 20 条。 | `wechat_channels.collection_videos` | 12 | https://socialtoai.com/zh/wechat-channels-collection-videos-api.md | ## 常见问题 **需要视频号账号，或者申请视频号官方的 API 吗？** 不需要，只要一把 SocialToAI 的 Key。返回的是视频号上公开可见的内容和账号信息，你不用登录视频号，也不用在那边申请任何东西。