AgentBodyAgentBody
登录

YouTube 评论搜索 API

一次带鉴权的 GET 把公开 YouTube 视频的评论以 JSON 返回——作者、文本和互动计数，每次最多 50 条。

  • 单一 REST 端点
  • 结构化评论条目
  • 可调结果条数
  • 任意公开视频
  • 可预期的错误码
  • 五语言示例
工具APIAgent

请求示例

查看 API 文档 完整 API 文档 
curl "https://api.agentbody.io/v1/youtube/comments?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&max_results=1" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"

响应示例

来自 OpenAPI 规范的已文档化响应。

Public top-level comments for one YouTube video.

{
  "items": [
    {
      "author": "Example Author",
      "id": "UgkxExample",
      "like_count": 12,
      "reply_count": 2,
      "text": "Great video!"
    }
  ],
  "total": 1,
  "video_id": "dQw4w9WgXcQ"
}

功能特点

用 YouTube 评论搜索 API 搭建受众调研、情绪管线和审核工具——视频 URL 进，结构化评论出。

单一 REST 端点

带 bearer API 密钥和公开视频 URL 调用 GET /v1/youtube/comments。API 以结构化 JSON 返回评论区——不用折腾 YouTube Data API 配额，也不用维护爬虫。

结构化评论条目

每条带 id、author、text、like_count、reply_count，响应回报 video_id 和 total。条目直接落进搜索索引、情绪管线或表格，无需定制解析。

可调结果条数

每次调用把 max_results 设为 1 到 50——快速核查取小样本，批量分析取满 50。评论区小于上限时网关可能返回更少。

任意公开视频

端点读取任意公开视频的公开评论区——不需要频道所有权，也没有 OAuth 授权流程。普通视频和 Shorts 走同一请求结构。

可预期的错误码

用文档化状态码处理失败：400 请求无效、401 密钥缺失或错误、502/503/504 暂时性上游问题——每类对应明确的修复或重试动作。

五语言示例

本页从端点的 OpenAPI 定义直接生成 curl、JavaScript、Python、Java、Go 请求示例——用你技术栈已有的 HTTP 客户端即可。

使用步骤

按以下步骤调用 YouTube 评论搜索 API：创建密钥，构造 GET 请求，处理返回的评论。

01

创建 API 密钥

创建 AgentBody 账号并在控制台生成 API 密钥。密钥放在服务端环境或受认可的密钥库，以 bearer 令牌发送——绝不进浏览器代码或客户端包。

02

构造 GET 请求

向 /v1/youtube/comments 发送 GET，带必填的 url 查询参数和可选的 max_results（1-50）。生成示例展示 curl、JavaScript、Python、Java、Go 的确切请求。

03

密钥留在服务端

从后端、serverless 函数或定时任务调用端点。若终端用户触发拉取，经你自己的端点代理，让密钥和计额掌控在你手里。

04

解析 JSON 响应

读取 items 数组——每条评论的 id、author、text、like_count、reply_count，外加 video_id 和 total。直接在文本上跑关键词搜索、情绪分析或审核过滤。

05

按需存储

持久化你的产品需要的字段，每行打上 video_id 和抓取时间标签。评论区会变——把分析所基于的快照存下来。

06

正确处理错误

400 修请求，401 配好密钥。502/503/504 带退避重试——它们是暂时性上游状况，不是永久失败。

常见问题

YouTube 评论搜索 API 是什么？

一个带鉴权的 GET 端点 /v1/youtube/comments，把一条 YouTube 视频的公开评论区以结构化 JSON 返回——条目带 id、author、text、like_count、reply_count，外加 video_id 和 total——每次调用一条视频 URL。

评论 API 的价格怎么算？

每次拉取消耗账号额度。用量计价由网关管理，而非本页写死的数字——在控制台查看当前单价。

它和 YouTube Data API 有什么区别？

没有 OAuth 授权流程、没有配额项目、不需要逐频道配置 API 密钥——一把 bearer 密钥、一个 URL 参数、一个规范化的评论结构。用 Google 完整评论树的功能换一次对任意公开视频可用的调用。

能在返回的评论里按关键词或作者搜吗？

可以——响应是结构化 JSON，在你的代码里对 items 数组跑任意关键词、短语或作者名过滤。API 返回评论区；匹配逻辑归你，灵活性由产品决定。

返回回复（楼中楼）吗？

端点返回一级评论，每条带 reply_count 字段显示回复数量。回复文本不在当前响应结构里——把 reply_count 当互动信号用。

怎么处理 API 错误？

400 修请求，401 修 bearer 密钥，把 502、503、504 当作暂时性上游故障带退避重试。记录状态码，让管线区分坏请求和暂时性问题。