logo

YouTube 账号列表采集

给一个 YouTube 账号或频道标识,返回其公开内容及关联账号资料

概览

按账号名或频道标识获取 YouTube 公开内容列表,并把视频信息与关联账号资料整理成可分析的记录。结果以内容编号为主键,适合持续采集后的去重、对比和归档。

除标题、链接和发布时间外,每条记录还保留观看数、视频时长、内容状态、共创标识、账号认证状态及采集来源。

数据说明

数据来自 YouTube 公开可见的账号、频道与内容页面,按接口定义默认以发布时间倒序返回,并按内容编号去重。发布时间、观看数、内容状态和账号资料均为采集时快照;接口文档未声明发布时间文本的时区,跨地区分析前应统一口径。观看数同时提供数值文本与页面展示文本,图片、徽章和链接列表保留上游原始文本。私密、受限、已删除或无法公开访问的内容不在结果中。

结果长什么样

每条记录代表一个去重后的 YouTube 公开内容:

内容编号内容标题账号名称发布时间观看数视频时长
8L98e7c56sQNEW RELEASE! Ulanzi VF01 Waist Level ViewfinderUlanzi2025-10-31T09:44:43180000:19
ca9OIFNiUU8Short Film Camera Rig SetupUlanzi2026-07-28T14:06:337070:37

此外还会返回内容链接、正文、封面、徽章、内容状态、共创信息、账号编号、认证状态、关键词、原始发布时间和采集时间等字段。

应用场景

  • 做内容表现分析时,结合「发布时间」「观看数」「视频时长」比较不同内容的传播表现。
  • 做账号内容盘点时,按「账号名称」「账号编号」聚合内容,并用认证字段补充账号背景。
  • 做内容资产巡检时,比对「内容状态」「内容链接」「采集时间」,发现公开状态变化。
  • 做共创内容筛选时,使用「是否共创」「共创信息」定位合作内容,再按内容编号关联内部台账。

适用边界

单次任务处理 1 个 YouTube 账号或频道标识,最多采集 1000 条公开内容记录。

  • 适合用于
  • 需要按账号名或频道标识获取 YouTube 公开内容列表时
  • 需要整理视频标题、发布时间、观看数与关联账号资料时
  • 不要用于
  • 需要私密内容、账号后台数据或登录后可见信息时——本 App 仅覆盖公开数据
  • 需要视频评论、字幕或音频转写时——本 App 不提供这些明细

失败处理

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

  1. 1返回空结果通常表示标识无匹配账号或账号没有可见公开内容,可核对账号名或频道标识后重试
  2. 2任务提交结果不明时不要连续重复提交,避免产生重复任务
  3. 3鉴权失败属不可重试错误,需先检查执行环境中的 API Key 配置

输入参数

调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
account账号或频道标识stringulanzi要采集的 YouTube 账号名或频道标识,每次任务只处理一个;长度不得超过 512 个字符
crawl_num采集数量integer1–10001本次任务最多采集多少条公开内容记录,取值 1–1000

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
account_badges账号徽章string账号公开徽章列表的原始文本
account_display_id展示标识string账号对外展示的频道标识或短名称
account_id账号编号stringYouTube 账号或频道的公开标识
account_name账号名称string账号对外展示的名称
article_type内容类型string公开内容的类型
biz_id业务编号string上游记录的业务标识
channel_description_links频道链接string频道简介中公开链接列表的原始文本
channel_thumbnails频道头像string频道公开头像列表的原始文本
co_creator_info共创信息string内容共同创作者信息的原始文本
content_badges内容徽章string公开内容徽章列表的原始文本
content_id内容编号stringYouTube 公开内容的唯一标识
content_rich_thumbnails内容丰富缩略图string内容丰富缩略图列表的原始文本
content_status内容状态string公开内容在采集时的状态
content_text内容正文string公开内容附带的正文文本
content_title内容标题string公开内容的标题
content_url内容链接string公开内容的访问链接
cover_images封面图片string内容封面图片列表的原始文本
crawl_time采集时间string本条公开内容被采集的时间
is_collaboration是否共创boolean该内容是否为共同创作内容
is_verified是否认证boolean关联账号是否带有 YouTube 认证标识
is_verified_artist艺术家认证boolean关联账号是否为 YouTube 官方认证艺术家
keyword采集关键词string本条记录对应的采集关键词
keyword_type关键词类型string采集关键词的类型
publish_time发布时间string公开内容的标准化发布时间文本
raw_duration原始时长string公开内容展示的原始时长文本
raw_publish_time原始发布时间string公开内容展示的原始发布时间文本
source_item来源标识string本条记录对应的原始账号或频道标识
no_data是否无数据boolean该来源标识是否没有采集到公开内容
video_duration视频时长值string视频时长的原始数值文本
view_count观看数string公开内容观看次数的数值文本
view_count_text观看数文本string公开页面展示的观看次数文本

记录 Schema

输出按记录逐条返回。记录主键为 content_id,去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "account_badges": {
      "type": "string",
      "title": "账号徽章",
      "description": "账号公开徽章列表的原始文本"
    },
    "account_display_id": {
      "type": "string",
      "title": "展示标识",
      "description": "账号对外展示的频道标识或短名称"
    },
    "account_id": {
      "type": "string",
      "title": "账号编号",
      "description": "YouTube 账号或频道的公开标识"
    },
    "account_name": {
      "type": "string",
      "title": "账号名称",
      "description": "账号对外展示的名称"
    },
    "article_type": {
      "type": "string",
      "title": "内容类型",
      "description": "公开内容的类型"
    },
    "biz_id": {
      "type": "string",
      "title": "业务编号",
      "description": "上游记录的业务标识"
    },
    "channel_description_links": {
      "type": "string",
      "title": "频道链接",
      "description": "频道简介中公开链接列表的原始文本"
    },
    "channel_thumbnails": {
      "type": "string",
      "title": "频道头像",
      "description": "频道公开头像列表的原始文本"
    },
    "co_creator_info": {
      "type": "string",
      "title": "共创信息",
      "description": "内容共同创作者信息的原始文本"
    },
    "content_badges": {
      "type": "string",
      "title": "内容徽章",
      "description": "公开内容徽章列表的原始文本"
    },
    "content_id": {
      "type": "string",
      "title": "内容编号",
      "description": "YouTube 公开内容的唯一标识"
    },
    "content_rich_thumbnails": {
      "type": "string",
      "title": "内容丰富缩略图",
      "description": "内容丰富缩略图列表的原始文本"
    },
    "content_status": {
      "type": "string",
      "title": "内容状态",
      "description": "公开内容在采集时的状态"
    },
    "content_text": {
      "type": "string",
      "title": "内容正文",
      "description": "公开内容附带的正文文本"
    },
    "content_title": {
      "type": "string",
      "title": "内容标题",
      "description": "公开内容的标题"
    },
    "content_url": {
      "type": "string",
      "title": "内容链接",
      "description": "公开内容的访问链接"
    },
    "cover_images": {
      "type": "string",
      "title": "封面图片",
      "description": "内容封面图片列表的原始文本"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "本条公开内容被采集的时间"
    },
    "is_collaboration": {
      "type": "boolean",
      "title": "是否共创",
      "description": "该内容是否为共同创作内容"
    },
    "is_verified": {
      "type": "boolean",
      "title": "是否认证",
      "description": "关联账号是否带有 YouTube 认证标识"
    },
    "is_verified_artist": {
      "type": "boolean",
      "title": "艺术家认证",
      "description": "关联账号是否为 YouTube 官方认证艺术家"
    },
    "keyword": {
      "type": "string",
      "title": "采集关键词",
      "description": "本条记录对应的采集关键词"
    },
    "keyword_type": {
      "type": "string",
      "title": "关键词类型",
      "description": "采集关键词的类型"
    },
    "publish_time": {
      "type": "string",
      "title": "发布时间",
      "description": "公开内容的标准化发布时间文本"
    },
    "raw_duration": {
      "type": "string",
      "title": "原始时长",
      "description": "公开内容展示的原始时长文本"
    },
    "raw_publish_time": {
      "type": "string",
      "title": "原始发布时间",
      "description": "公开内容展示的原始发布时间文本"
    },
    "source_item": {
      "type": "string",
      "title": "来源标识",
      "description": "本条记录对应的原始账号或频道标识"
    },
    "no_data": {
      "type": "boolean",
      "title": "是否无数据",
      "description": "该来源标识是否没有采集到公开内容"
    },
    "video_duration": {
      "type": "string",
      "title": "视频时长值",
      "description": "视频时长的原始数值文本"
    },
    "view_count": {
      "type": "string",
      "title": "观看数",
      "description": "公开内容观看次数的数值文本"
    },
    "view_count_text": {
      "type": "string",
      "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-account-list": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/youtube-account-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。

如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。

价格

提交一次公开内容采集

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

¥0.001/
返回一条公开内容记录

按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。

¥0.015/ 30 条

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

立即体验

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

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