logo

YouTube 视频详情采集

提交一个或多个 YouTube 视频链接,返回视频标题、简介、频道与播放、点赞、评论等公开指标

概览

想批量了解一批 YouTube 视频到底表现如何——标题讲什么、哪个频道发的、播放和点赞评论涨到多少、什么时候发的?把视频链接交给它,它会去把每条视频的公开详情拉回来,整理成一张可以直接导出表格的底表,省去你一个个打开视频页手抄。

比起手动逐个点开视频记录数据,它把一批链接一次跑完,重复的视频只保留一条,适合做内容盘点、竞品频道对比和选题参考的原始数据。

数据说明

数据取自 YouTube 公开视频的详情,按你提交的链接逐条返回,同一个视频只出现一次。播放量、点赞数、评论数是取数当时的公开计数,原始文本可能带「万」「亿」等单位,不是纯净数字;频道粉丝数同理。发布时间是视频公开显示的时间。只覆盖你提交了链接的那批视频,未提交的、设为私密的、已下架的不在其中。

结果长什么样

每条记录是一个视频的详情:

视频编号视频标题频道名称播放量点赞数评论数
--8pJvYNcX4Every AI Model Explained In 20 MinutesTina Huang612262979226
mpUwmWy_tlg只要299!让你的工作室上NEXT LEVEL!龙光Justin29290

另有视频链接、简介、频道账号与主页、频道编号、封面图、频道粉丝数、采集时间、发布时间与来源站点等字段。

应用场景

  • 做内容盘点时,把「播放量」「点赞数」「评论数」按量级分档,看哪些视频真正跑出来、哪些不温不火,给选题找方向。
  • 做频道对比时,用「频道名称」「频道粉丝数」聚合同一创作者的多条视频,看谁的体量大、谁的互动率高。
  • 盯内容走势时,隔一段时间跑同一批链接,比对「播放量」「评论数」的变化,判断哪些视频在持续走红。
  • 做选题参考时,从「视频标题」「视频简介」里看高播放视频讲什么、卖什么,提炼可借鉴的切入点。

适用边界

单次任务可提交多个 YouTube 视频链接;结果一次调用合并返回,平台最多翻 100 页(每页 20 条)

  • 适合用于
  • 需要批量获取 YouTube 视频的标题、简介、频道与播放、点赞、评论等公开指标时
  • 需要按视频链接把详情落库,做竞品盘点或内容分析时
  • 不要用于
  • 只需要视频链接本身或搜索结果列表——本 App 取的是单条视频的详情
  • 需要实时评论区、字幕等未包含在返回字段里的数据时

失败处理

作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1鉴权失败属不可重试错误,需先在执行环境配置正确的 API Key
  2. 2任务状态变为 FAILED、EXPIRED 或 SUBMIT_FAILED 时可原样重新提交视频链接重试
  3. 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视频编号stringYouTube 视频唯一标识(视频 ID)
content_url视频链接string视频在 YouTube 上的播放页链接
content_title视频标题string视频标题
content_text视频简介string视频简介或文案正文
account_name频道名称string发布频道名称
account_id频道账号string频道账号标识(如 @xxx)
account_home_url频道主页string频道主页链接
channel_id频道编号stringYouTube 频道 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,去重、增量、关联以它为准。

output.schema
{
  "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 配置
{
  "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)。

价格

提交一次采集任务

每提交一次任务计费一次,与返回条数无关。

¥0.001/
返回一条视频详情

按实际成功返回的数据条数计费,任务失败不计费。

¥0.01/

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.01 / 条起