概览
想批量了解一批 YouTube 视频到底表现如何——标题讲什么、哪个频道发的、播放和点赞评论涨到多少、什么时候发的?把视频链接交给它,它会去把每条视频的公开详情拉回来,整理成一张可以直接导出表格的底表,省去你一个个打开视频页手抄。
比起手动逐个点开视频记录数据,它把一批链接一次跑完,重复的视频只保留一条,适合做内容盘点、竞品频道对比和选题参考的原始数据。
数据说明
数据取自 YouTube 公开视频的详情,按你提交的链接逐条返回,同一个视频只出现一次。播放量、点赞数、评论数是取数当时的公开计数,原始文本可能带「万」「亿」等单位,不是纯净数字;频道粉丝数同理。发布时间是视频公开显示的时间。只覆盖你提交了链接的那批视频,未提交的、设为私密的、已下架的不在其中。
结果长什么样
每条记录是一个视频的详情:
| 视频编号 | 视频标题 | 频道名称 | 播放量 | 点赞数 | 评论数 |
|---|---|---|---|---|---|
| --8pJvYNcX4 | Every AI Model Explained In 20 Minutes | Tina Huang | 61226 | 2979 | 226 |
| mpUwmWy_tlg | 只要299!让你的工作室上NEXT LEVEL! | 龙光Justin | 29 | 29 | 0 |
另有视频链接、简介、频道账号与主页、频道编号、封面图、频道粉丝数、采集时间、发布时间与来源站点等字段。
应用场景
- 做内容盘点时,把「播放量」「点赞数」「评论数」按量级分档,看哪些视频真正跑出来、哪些不温不火,给选题找方向。
- 做频道对比时,用「频道名称」「频道粉丝数」聚合同一创作者的多条视频,看谁的体量大、谁的互动率高。
- 盯内容走势时,隔一段时间跑同一批链接,比对「播放量」「评论数」的变化,判断哪些视频在持续走红。
- 做选题参考时,从「视频标题」「视频简介」里看高播放视频讲什么、卖什么,提炼可借鉴的切入点。
适用边界
单次任务可提交多个 YouTube 视频链接;结果一次调用合并返回,平台最多翻 100 页(每页 20 条)
- 适合用于
- 需要批量获取 YouTube 视频的标题、简介、频道与播放、点赞、评论等公开指标时
- 需要按视频链接把详情落库,做竞品盘点或内容分析时
- 不要用于
- 只需要视频链接本身或搜索结果列表——本 App 取的是单条视频的详情
- 需要实时评论区、字幕等未包含在返回字段里的数据时
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1鉴权失败属不可重试错误,需先在执行环境配置正确的 API Key
- 2任务状态变为 FAILED、EXPIRED 或 SUBMIT_FAILED 时可原样重新提交视频链接重试
- 3部分成功(PARTIAL_SUCCEEDED)仍可取回已成功的视频详情
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| video_urls | 视频链接清单 | array<object> | 是 | — | 最多 200 项 | [{"kw":"https://www.youtube.com/watch?v=mpUwmWy_tlg"}] | 要采集详情的 YouTube 视频链接列表,一次任务可提交多个;每个元素是一个视频链接 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| content_id | 视频编号 | string | — | YouTube 视频唯一标识(视频 ID) |
| content_url | 视频链接 | string | — | 视频在 YouTube 上的播放页链接 |
| content_title | 视频标题 | string | — | 视频标题 |
| content_text | 视频简介 | string | — | 视频简介或文案正文 |
| account_name | 频道名称 | string | — | 发布频道名称 |
| account_id | 频道账号 | string | — | 频道账号标识(如 @xxx) |
| account_home_url | 频道主页 | string | — | 频道主页链接 |
| channel_id | 频道编号 | string | — | YouTube 频道 ID |
| account_avatar_url | 频道头像 | string | — | 频道头像图片链接 |
| account_identity | 频道身份 | string | — | 频道账号的身份标识,未提供时为空 |
| publish_time | 发布时间 | string | — | 视频发布时间(ISO 8601) |
| raw_publish_time | 原始发布时间 | string | — | 采集页面展示的原始发布时间文本,未提供时为空 |
| play_count | 播放量 | string | — | 视频播放次数,原始文本(可能含万、亿等单位) |
| like_count | 点赞数 | string | — | 视频点赞数,原始文本 |
| comment_count | 评论数 | string | — | 视频评论数,原始文本 |
| comments_turned_off | 评论关闭 | boolean | — | 视频是否已关闭评论功能 |
| account_fans_count | 频道粉丝数 | string | — | 频道粉丝数,原始文本 |
| cover_image_url | 封面图 | string | — | 视频封面图链接 |
| article_type | 内容类型 | string | — | 视频内容的类型标识,未提供时为空 |
| message_type | 内容形态 | string | — | 视频内容的消息类型标识 |
| description_links | 简介链接 | string | — | 视频简介中包含的链接原始文本,未提供时为空 |
| hashtags | 话题标签 | string | — | 视频关联的话题标签原始文本,未提供时为空 |
| co_creator_info | 共创信息 | string | — | 视频共创作者信息的原始文本,未提供时为空 |
| keyword_list | 关联检索值 | string | — | 结果关联的检索值,视频详情任务中通常为提交的视频链接 |
| biz_id | 业务标识 | string | — | 该结果对应的业务对象标识 |
| terminal_name | 终端类型 | string | — | 数据采集所使用的终端类型标识 |
| crawl_time | 采集时间 | string | — | 数据被采集落库的时间(ISO 8601) |
| clean_update_time | 更新时间 | string | — | 结果最近清洗落库的时间(ISO 8601) |
| site_name | 来源站点 | string | — | 数据来源站点,固定为 youtube |
| submitted_video_url | 提交视频链接 | string | — | 本次任务提交时填写的 YouTube 视频链接 |
| no_data | 无数据 | boolean | — | 该视频链接是否未采集到有效视频详情 |
记录 Schema
输出按记录逐条返回。记录主键为 content_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "视频编号",
"description": "YouTube 视频唯一标识(视频 ID)"
},
"content_url": {
"type": "string",
"title": "视频链接",
"description": "视频在 YouTube 上的播放页链接"
},
"content_title": {
"type": "string",
"title": "视频标题",
"description": "视频标题"
},
"content_text": {
"type": "string",
"title": "视频简介",
"description": "视频简介或文案正文"
},
"account_name": {
"type": "string",
"title": "频道名称",
"description": "发布频道名称"
},
"account_id": {
"type": "string",
"title": "频道账号",
"description": "频道账号标识(如 @xxx)"
},
"account_home_url": {
"type": "string",
"title": "频道主页",
"description": "频道主页链接"
},
"channel_id": {
"type": "string",
"title": "频道编号",
"description": "YouTube 频道 ID"
},
"account_avatar_url": {
"type": "string",
"title": "频道头像",
"description": "频道头像图片链接"
},
"account_identity": {
"type": "string",
"title": "频道身份",
"description": "频道账号的身份标识,未提供时为空"
},
"publish_time": {
"type": "string",
"title": "发布时间",
"description": "视频发布时间(ISO 8601)"
},
"raw_publish_time": {
"type": "string",
"title": "原始发布时间",
"description": "采集页面展示的原始发布时间文本,未提供时为空"
},
"play_count": {
"type": "string",
"title": "播放量",
"description": "视频播放次数,原始文本(可能含万、亿等单位)"
},
"like_count": {
"type": "string",
"title": "点赞数",
"description": "视频点赞数,原始文本"
},
"comment_count": {
"type": "string",
"title": "评论数",
"description": "视频评论数,原始文本"
},
"comments_turned_off": {
"type": "boolean",
"title": "评论关闭",
"description": "视频是否已关闭评论功能"
},
"account_fans_count": {
"type": "string",
"title": "频道粉丝数",
"description": "频道粉丝数,原始文本"
},
"cover_image_url": {
"type": "string",
"title": "封面图",
"description": "视频封面图链接"
},
"article_type": {
"type": "string",
"title": "内容类型",
"description": "视频内容的类型标识,未提供时为空"
},
"message_type": {
"type": "string",
"title": "内容形态",
"description": "视频内容的消息类型标识"
},
"description_links": {
"type": "string",
"title": "简介链接",
"description": "视频简介中包含的链接原始文本,未提供时为空"
},
"hashtags": {
"type": "string",
"title": "话题标签",
"description": "视频关联的话题标签原始文本,未提供时为空"
},
"co_creator_info": {
"type": "string",
"title": "共创信息",
"description": "视频共创作者信息的原始文本,未提供时为空"
},
"keyword_list": {
"type": "string",
"title": "关联检索值",
"description": "结果关联的检索值,视频详情任务中通常为提交的视频链接"
},
"biz_id": {
"type": "string",
"title": "业务标识",
"description": "该结果对应的业务对象标识"
},
"terminal_name": {
"type": "string",
"title": "终端类型",
"description": "数据采集所使用的终端类型标识"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "数据被采集落库的时间(ISO 8601)"
},
"clean_update_time": {
"type": "string",
"title": "更新时间",
"description": "结果最近清洗落库的时间(ISO 8601)"
},
"site_name": {
"type": "string",
"title": "来源站点",
"description": "数据来源站点,固定为 youtube"
},
"submitted_video_url": {
"type": "string",
"title": "提交视频链接",
"description": "本次任务提交时填写的 YouTube 视频链接"
},
"no_data": {
"type": "boolean",
"title": "无数据",
"description": "该视频链接是否未采集到有效视频详情"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"mona_kk__youtube-detail-fetch": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/youtube-detail-fetch",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。