/v1/comments"platform": "youtube"YouTube 评论接口
一条视频下的评论。
取任意公开 YouTube 视频下的评论,拿回正文、点赞数和回复数:用 HTTP 取 JSON,或在 AI 客户端里通过 MCP 调用。YouTube 评论 API(数据接口)每次调用 2 积分(约 $0.004–$0.0067),失败不扣,返回格式和其他调用相同。最近实测:2026-10-31。
最近更新:
limit: 100,一次调用自动翻页,最多 5 页、10 积分。够数或没有下一页就停,用不上的页不扣,失败的页也不扣。读 1,000 条约 100 积分,约 ¥2.4($0.33)。每日监控:对你的 AI 说“每天帮我盯着”,这个调用每天自己跑,只把新内容发给你,一个月最多 62 积分,约 ¥1.5($0.21)。 看怎么设
调用 YouTube 评论,你会拿到什么。
取自一次录制的返回。
录制的一次调用返回了 20 条,下面是第一条的每个字段。名称和正文在示例里去掉了,数字是录制时的真实值。
给 AI 读更省:同一份录制数据(20 条),平台原始 JSON 约 7,450 token,这个接口返回约 2,777 token,少 62%(2026-11-06 实测)。 测量方法
| 字段 | 录制时的值 |
|---|---|
| url | null:YouTube 给不了 |
| text | 示例里已去掉 |
| published_at | null:YouTube 给不了 |
| author.label | anonymous_1 |
| metrics.likes | 427,000 |
| reply_count | 735 |
| content_id | null:YouTube 给不了 |
| parent_id | null |
| root_id | null |
每次 2 积分(≈ $0.004–$0.0067),$10 约够 1,500 次。
YouTube 评论的请求与返回
curl https://api.socialtoai.com/v1/comments \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "youtube", "id": "dQw4w9WgXcQ" }'import osimport uuidimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/comments", headers={ "Authorization": f"Bearer {os.environ['SOCIALTOAI_API_KEY']}", # A new key for each request; the same one again retries it without paying twice. "Idempotency-Key": str(uuid.uuid4()), }, json={ "platform": "youtube", "id": "dQw4w9WgXcQ", },)print(response.json())# 已经通过 MCP 接好了?直接用大白话问。读一下这条 YouTube 视频下的评论:dQw4w9WgXcQ# 你的 AI 会调用 comments 工具,参数是:{ "platform": "youtube", "id": "dQw4w9WgXcQ"}取值sort{ "platform": "youtube", "status": "ok", "items": [ { "platform": "youtube", "id": "…", "ref": "…", "approx": [ { "field": "metrics.likes", "kind": "approximate" } ], "type": "comment", "url": null, "text": "…", "published_at": null, "author": { "label": "anonymous_1" }, "metrics": { "likes": 427000 }, "reply_count": 735, "content_id": null, "parent_id": null, "root_id": null } ], "unavailable": ["url", "published_at", "content_id"], "page": { "has_more": true, "cursor": "cur_…", "cursor_expires_at": "2026-10-25T09:24:11.000Z" }, "cost_credits": 2}示例里的名称和正文已去掉,数字是录制时的真实值。
YouTube 评论的参数。
6 个,1 个必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里,不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| platform | string | 必填 | — | 这一页固定填 "youtube"。 |
| id | string | 几个里给一个 | — | 视频编号 |
| url | string | 几个里给一个 | — | 视频链接:watch、shorts、embed、live 或 youtu.be 的写法 |
| sort | string | 选填 | "popular" | 按热门排,或按最新排"popular""latest" |
| reply_of | string | 选填 | — | 给了它就返回某条评论下的回复(2 积分)。 |
| cursor | string | 选填 | — | 填上一次返回的 page.cursor,取下一页。 |
这些值从哪里拿。
id视频编号(例如 dQw4w9WgXcQ)
这些接口返回的每一条都带 ref,原样填进来即可:
searchYouTube 搜索接口user_postsYouTube 账号作品接口
也可以直接填网页链接,返回里的 url 字段就是。
YouTube 评论返回的字段。
YouTube 给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].url | string始终 null | 评论的链接,平台有才给。 |
| items[].text | string | 评论原文。 |
| items[].published_at | string始终 null | 发布时间,ISO 8601(UTC)。 |
| items[].author.label | string | 匿名标记,在同一次返回里保持一致;写的人不具名。 |
| items[].metrics.likes | integer | 点赞数。 |
| items[].reply_count | integer | 回复数。 |
| items[].content_id | string始终 null | 评论所在内容的编号。 |
| items[].parent_id | string | 它直接回复的那条评论;一级评论为 null。 |
| items[].root_id | string | 所在回复串的一级评论。 |
nullYouTube 给不了的字段null 的意思是“YouTube 没给这个值”,不要当成 0。这些字段在这个调用里始终是 null:
url评论的链接,平台有才给。published_at发布时间,ISO 8601(UTC)。content_id评论所在内容的编号。
请求里带上对应的参数,就换成另一种返回:
reply_of某条评论下的回复2 积分和 TikTok 评论比,这个调用少给发布时间。
每一条另有 platform、id、ref、approx、type;items 外面的部分每个调用都一样。 返回格式
YouTube 评论的翻页与计费。
每把 Key 每秒 5 次,购买后 20 次;超出不扣费。 频率限制
失败的调用 0 积分,不会自动重试。 错误码
首屏的“最近实测”是最近一次真实调用成功的日子。每次调用从平台读取,返回里的 fetched_at 是读取时间;同一把 Key 5 分钟内重发完全相同的请求算重放(replayed: true),0 积分,返回第一次读到的结果。
接好 MCP 后,这样问就会用到 YouTube 评论。
读一下这条 YouTube 视频下的评论:dQw4w9WgXcQ
2 积分comments {"platform":"youtube","id":"dQw4w9WgXcQ"}读一下这条 YouTube 视频下的评论:dQw4w9WgXcQ,sort 取 latest。
2 积分comments {"platform":"youtube","id":"dQw4w9WgXcQ","sort":"latest"}在 YouTube 上搜和“meteor shower”有关的视频,再对前 3 个结果:读一下这条 YouTube 视频下的评论。
8 积分search {"platform":"youtube","query":"meteor shower"}comments {"platform":"youtube","id":"<ref>"} × 3
交给你的 AI。
复制给 Claude 或 ChatGPT。
怎么接用 SocialToAI 的 MCP 服务(https://mcp.socialtoai.com/mcp)完成这件事:读一下这条 YouTube 视频下的评论:dQw4w9WgXcQ调用 comments 工具,参数是 {"platform":"youtube","id":"dQw4w9WgXcQ"}。必填:id、url;可选:sort(popular、latest)。要多条就传 limit(比如 limit=100,最多 5 页),一次调用自动翻页,不用自己一页页取;每页 2 积分,用不上的页不扣。开跑前先算出总共要多少积分,问我同意了再调用。如果还没接上 SocialToAI,告诉我怎么接,不要让我把 Key 贴进对话。回答时附上你用到的每一条的链接,最后告诉我花了多少积分。接好 MCP 后把这段话贴进对话。里面没有 Key:在 Claude 和 ChatGPT 里登录授权,其他客户端把 Key 放在请求头里。
这些工具运行时会调用它。
用到它的工作场景。
同一个调用,换个平台。
全部平台和价格/v1/comments{ "platform": "youtube", "id": "dQw4w9WgXcQ" }2 积分每次调用接着看。
官方能做什么、谁能申请、多少钱,带来源。
按链接取任意公开视频的完整字幕。
哪些平台能取评论、每页多少条、多少积分。
评论在说什么,带原话:用工具还是让 AI 读,各平台价格,一次录制
让你的 AI 直接读 YouTube。