POST
/v1/comments"platform": "wechat_channels"视频号评论接口
一条视频下的评论。
视频号评论 API(数据接口)返回一条公开视频号视频下的评论:正文、点赞数和时间,返回格式和 SocialToAI 的其他调用相同。每次调用 12 积分(约 $0.024–$0.04),失败不扣。用 HTTP 调用,或让 AI 客户端通过 MCP 调用。最近实测:2026-10-17。
12 积分每次调用
每页最多 30 条一次调用返回一页
2026-10-17最近实测
881 B示例返回的体积(1 条)
最近更新:
请求与返回
curl https://api.socialtoai.com/v1/comments \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "platform": "wechat_channels", "id": "14559898883113486609" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/comments", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "platform": "wechat_channels", "id": "14559898883113486609", },)print(response.json())# 已经通过 MCP 接好了?直接用大白话问。读一下这条视频号视频下的评论:14559898883113486609# 你的 AI 会调用 comments 工具,参数是:{ "platform": "wechat_channels", "id": "14559898883113486609"}200 OK881 B12 积分
{ "platform": "wechat_channels", "status": "ok", "items": [ { "platform": "wechat_channels", "id": "…", "ref": "…", "approx": [], "type": "comment", "url": null, "text": "…", "published_at": "2024-12-31T20:01:33.000Z", "author": { "label": "anonymous_1" }, "metrics": { "likes": 349 }, "reply_count": null, "content_id": "…", "parent_id": null, "root_id": null } ], "unavailable": ["url", "reply_count"], "page": { "has_more": true, "cursor": "cur_…", "cursor_expires_at": "2026-10-13T03:55:36.000Z" }, "cost_credits": 12}likes 349回复
null示例里的名称和正文已去掉,数字是录制时的真实值。
示例数据录制的 22 条里的 1 条
3 个参数。
2 个必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里,不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| platform | string | 必填 | — | 这一页固定填 "wechat_channels"。 |
| id | string | 必填 | — | 作品编号,一串数字;作品列表和作品详情里的 id 就是它 |
| cursor | string | 选填 | — | 填上一次返回的 page.cursor,取下一页。 |
这些值从哪里拿。
id作品编号,一串数字;作品列表和作品详情里的 id 就是它(例如 14559898883113486609)
这些接口返回的每一条都带 ref,原样填进来即可:
user_posts账号作品search搜索collection_videos合集里的视频
items 里每一条的字段。
视频号给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].url | string始终 null | 评论的链接,平台有才给。 |
| items[].text | string | 评论原文。 |
| items[].published_at | string | 发布时间,ISO 8601(UTC)。 |
| items[].author.label | string | 匿名标记,在同一次返回里保持一致;写的人不具名。 |
| items[].metrics.likes | integer | 点赞数。 |
| items[].reply_count | integer始终 null | 回复数。 |
| items[].content_id | string | 评论所在内容的编号。 |
| items[].parent_id | string | 它直接回复的那条评论;一级评论为 null。 |
| items[].root_id | string | 所在回复串的一级评论。 |
null视频号给不了的字段null 的意思是“视频号没给这个值”,不要当成 0。这些字段在这个调用里始终是 null:
url评论的链接,平台有才给。reply_count回复数。
每一条另有 platform、id、ref、approx、type;items 外面的部分每个调用都一样。 返回格式
会发生什么。
一次调用返回一页,最多 30 条;page.has_more 为 true 时把 page.cursor 填进 cursor 取下一页,每页 12 积分,cursor 30 分钟内有效。
正常执行但没有结果,算一次成功的调用:status 为 "empty",items 为空,扣 12 积分。
每把 Key 每秒 1 次,购买后 5 次;超出不扣费。 频率限制
失败的调用 0 积分,不会自动重试。 错误码
接好 MCP 后,这样问就会用到它。
读一下这条视频号视频下的评论:14559898883113486609
12 积分comments {"platform":"wechat_channels","id":"14559898883113486609"}在视频号上搜和“露营装备推荐”有关的视频,再对前 3 个结果:读一下这条视频号视频下的评论。
48 积分search {"platform":"wechat_channels","query":"露营装备推荐"}comments {"platform":"wechat_channels","id":"<ref>"} × 3
这些工具运行时会调用它。
同一个调用,换个平台。
全部平台和价格POST
/v1/comments{ "platform": "wechat_channels", "id": "14559898883113486609" }12 积分每次调用请求里只改 platform 这一个词,返回的结构不变。
常见问题。
简短回答。
视频号的全部接口需要视频号账号,或者申请视频号官方的 API 吗?
不需要,只要一把 SocialToAI 的 Key。返回的是视频号上公开可见的内容和账号信息,你不用登录视频号,也不用在那边申请任何东西。