万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

YouTube

YouTube API

视频、Shorts、评论、字幕与频道数据——全球视频内容与观众反馈。 调用 POST /api/v1/social ；返回结构化 JSON，$0.56 / 千次；失败不计费。

免费开始 看文档

8

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

YouTube 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordsort默认 10 · 最多 50同步$0.56 / 千次id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform
profileurl——同步$0.56 / 千次channel_id · name · url · bio · subscriber_count · video_count · view_count · is_verified · location · avatar_url · banner_url · created_at · platform
user_postsurlsince, sort默认 10 · 最多 50同步$0.56 / 千次id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform
videourl——同步$0.56 / 千次id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform
commentsurlsince, sort默认 20 · 最多 100同步$0.56 / 千次id · text · author_name · like_count · reply_count · posted_at · is_reply · reply_to_id · platform
followersusernamechannel—同步$0.56 / 千次id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform
transcripturllanguage—同步$0.56 / 千次id · url · title · text · segments · language · available_languages · channel_id · channel_name · channel_username · view_count · like_count · comment_count · posted_at · platform
shortsusernamechannel, since, sort默认 20 · 最多 100同步$0.56 / 千次id · url · title · thumbnail_url · view_count · like_count · duration · posted_at · author_name · author_id · author_url · platform

YouTube 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 YouTube 主页或对象详情 API？

profile

使用 platform="youtube"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 channel_id、name、url、bio、subscriber_count、video_count 等 13 个字段。

YouTube profile 的参数分别是什么意思？

url必填
YouTube 频道 URL，用于读取频道资料；不接受视频 URL，也不用 since/sort 筛选频道本身。

YouTube 官方说明 @handle 是唯一频道标识，并可形成对应频道 URL；这可核对 handle 形式的频道 URL，但不能证明所有旧式、自定义或 /channel/ URL 的解析行为，也不为 EveryInfra 的全部 profile 字段背书。官方来源：YouTube：频道 handle 与主页 URL来源核查：

YouTube 特有返回字段与含义（4）
channel_id
频道 ID（UC 开头）。
subscriber_count
订阅数。
video_count
视频数。
banner_url
频道横幅。

怎么调用 YouTube 用户内容 API？

user_posts

使用 platform="youtube"、action="user_posts" 调用“用户内容”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、url、title、text、author_name、author_username 等 14 个字段。

YouTube user_posts 的参数分别是什么意思？

url必填
YouTube 频道 URL，用于列出该频道的常规视频；Shorts 请用 shorts 动作。

YouTube 官方以频道 uploads 播放列表及 playlistItems 列出上传视频；EveryInfra 将频道 URL 解析到相应标识属于自身实现，该来源不证明任意 URL、完整历史记录，也不支持把 since 或 newest/oldest/popular 当作 playlistItems 的原生参数。官方来源：YouTube Data API：频道 uploads 播放列表来源核查：

since可选
频道视频的最早发布日期，格式 YYYY-MM-DD；只用于 user_posts 列表。
sort可选
频道视频排序：newest 最新、oldest 最早、popular 热门。
查看全部 3 个允许值

newestoldestpopular

YouTube 特有返回字段与含义（1）
duration
时长。

怎么调用 YouTube 视频详情 API？

video

使用 platform="youtube"、action="video" 调用“视频详情”能力；返回单个对象，主要包含 id、url、title、text、author_name、author_username 等 14 个字段。

YouTube video 的参数分别是什么意思？

url必填
具体 YouTube 视频 URL，返回该单视频元数据；不接受搜索用的日期、时长或排序筛选。

Videos: list 可按视频 id 获取 snippet、statistics 等资源部分；EveryInfra 从视频 URL 解析 ID 属于自身实现，该来源不证明任意 URL 均可访问、全部字段都会返回或不受删除、隐私和权限状态影响。官方来源：YouTube Data API：按视频 ID 获取资源来源核查：

YouTube 特有返回字段与含义（1）
duration
时长。

怎么调用 YouTube 评论 API？

comments

使用 platform="youtube"、action="comments" 调用“评论”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、text、author_name、like_count、reply_count、posted_at 等 9 个字段。

YouTube comments 的参数分别是什么意思？

url必填
具体 YouTube 视频 URL，返回该视频评论。
since可选
评论的最早发布日期，格式 YYYY-MM-DD；它筛选评论，不筛选视频发布日期。
sort可选
评论排序：newest 最新评论、popular 热门评论。

CommentThreads: list 可按 videoId 获取评论线程，并用 time 或 relevance 排序，可分别核对 EveryInfra 的 newest 与 popular 产品映射；since 不是该官方接口的原生参数，线程结果也可能不包含全部回复。官方来源：YouTube Data API：评论线程及排序来源核查：

查看全部 2 个允许值

newestpopular

YouTube 特有返回字段与含义（2）
is_reply
是否为回复。
reply_to_id
被回复评论 ID。

怎么调用 YouTube 粉丝数量 API？

followers

使用 platform="youtube"、action="followers" 调用“粉丝数量”能力；返回单个对象，主要包含 id、username、url、follower_count、following_count、post_count 等 10 个字段。

YouTube followers 的参数分别是什么意思？

username必填
YouTube 频道 handle，可带 @；返回订阅者数量，不是订阅者名单。

YouTube 将 handle 定义为以 @ 开头的唯一频道标识，与频道显示名称不同。官方来源：YouTube：了解频道 handle来源核查：

channel可选
username 的低优先级兼容输入；公开请求仍须提供 username，且 username 会优先于 channel。请传频道 handle，不要传 /channel/UC… URL。
YouTube 特有返回字段与含义（2）
connection_count
关联数。
precision
数据精确度标记（订阅数等被 YouTube 圆整时的标注）。

怎么调用 YouTube 视频文稿 API？

transcript

使用 platform="youtube"、action="transcript" 调用“视频文稿”能力；返回单个对象，主要包含 id、url、title、text、segments、language 等 15 个字段。

YouTube transcript 的参数分别是什么意思？

url必填
具体 YouTube 视频 URL，用于提取该视频字幕或文稿；不是频道批量视频查询。
language可选
transcript 请求的字幕/文稿语言代码，按可用语言获取，不保证自动翻译或所有执行路径都遵从。

Captions: download 可下载指定字幕轨，并支持 tlang 目标翻译语言；调用需要 OAuth 及相应视频或字幕权限，不能据此承诺任意公开视频 URL 都有 transcript、总能自动翻译或一定存在请求语言。官方来源：YouTube Data API：下载字幕轨与目标翻译语言来源核查：

YouTube 特有返回字段与含义（5）
channel_id
频道 ID（UC 开头）。
channel_name
频道名。
channel_username
频道 @handle。
segments
字幕分段（带时间戳文本）。
available_languages
可用字幕语言列表。

怎么调用 YouTube Shorts 短视频 API？

shorts

使用 platform="youtube"、action="shorts" 调用“Shorts 短视频”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、thumbnail_url、view_count、like_count 等 12 个字段。

YouTube shorts 的参数分别是什么意思？

username必填
YouTube 频道 handle，可带 @；返回该频道的 Shorts，不是全站关键词搜索。

YouTube 将 handle 定义为以 @ 开头的唯一频道标识，与频道显示名称不同。官方来源：YouTube：了解频道 handle来源核查：

channel可选
username 的低优先级兼容输入；公开请求仍须提供 username，且 username 会优先于 channel。请传频道 handle，不要传 /channel/UC… URL。
since可选
Shorts 的最早发布日期，格式 YYYY-MM-DD。
sort可选
Shorts 排序：newest 最新、oldest 最早、popular 热门。
查看全部 3 个允许值

newestoldestpopular

YouTube 特有返回字段与含义（1）
duration
时长。
YouTube search 调用流程一次 YouTube search 调用的全过程：向 POST /api/v1/social 发送 platform="youtube"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、author_name 等字段；返回列表，单次最多 50 条，计费 $0.56 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "youtube"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表idurltitletextauthor_name
一次 YouTube search 调用的全过程：向 POST /api/v1/social 发送 platform="youtube"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、author_name 等字段；返回列表，单次最多 50 条，计费 $0.56 / 千次，失败与空结果不计费。

YouTube 原始字段名

EveryInfra 统一字段名

左边是 YouTube 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

YouTube 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 1 个字段名只在 YouTube 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • available_languages

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时（如纯文本帖）为 null。
text
正文内容，已去除 HTML 标签。长文可能被截断。
author_name
作者昵称（显示名）。
author_username
作者用户名（@handle），通常可用于拼 URL。
author_id
作者在原平台的唯一 ID。
author_url
作者在原平台的主页链接。
like_count
点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
comment_count
评论数。null 表示不公开，不等于 0。
view_count
浏览/播放数。null 表示不公开，不等于 0。
duration
时长。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
channel_id
频道 ID（UC 开头）。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
subscriber_count
订阅数。
video_count
视频数。
is_verified
是否为平台认证账号（蓝V等）。null 表示无法判定。
location
地理位置描述，原文透传，格式随平台而异。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
banner_url
频道横幅。
created_at
创建时间，格式同 posted_at。
reply_count
回复数，通常用于评论的子回复。null 表示不公开。
is_reply
是否为回复。
reply_to_id
被回复评论 ID。
username
用户名（@handle）。
follower_count
粉丝数。null 表示不公开，不等于 0。
following_count
关注数。null 表示不公开，不等于 0。
post_count
发布内容总数。null 表示不公开，不等于 0。
connection_count
关联数。
precision
数据精确度标记（订阅数等被 YouTube 圆整时的标注）。
segments
字幕分段（带时间戳文本）。
language
内容语言代码（如 zh、en），由平台判定，可能不准。
available_languages
可用字幕语言列表。
channel_name
频道名。
channel_username
频道 @handle。
thumbnail_url
缩略图链接，分辨率低于 image_url。

请求填写示例

这里检索视频主题；频道资料、字幕和评论使用各自目标。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

youtube_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"youtube","action":"search","params":{"keyword":"urban gardening tutorial"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "author_name": null,
  "author_username": null,
  "author_id": null,
  "author_url": null,
  "like_count": null,
  "comment_count": null,
  "view_count": null,
  "duration": null,
  "posted_at": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

按主题和排序发现 YouTube 视频

用 search 搜索视频候选，再用具体视频或频道地址继续读取。

查看 search 的 sort 参数 →
  • keyword 是视频检索词；sort 可填 relevance 相关性、newest 最近发布、most_viewed 播放量或 top_rated 评分排序。它不是频道搜索、播放列表搜索或带日期边界的全量归档，当前公开参数也没有任意起止日期。
  • author_id / author_url 定位发布频道，不是视频本身；duration 保留实际返回格式，不能一律当成秒数。计数与描述可能缺失，搜索摘要不是字幕全文，也不应把单次结果名次解释为官方权威排名。

核对 YouTube 频道资料，而不是把视频计数当频道计数

用 profile 读取频道内容所携带的资料，返回一个频道对象。

查看 profile 的 url 参数 →
  • url 填频道页，而不是 watch 视频页。channel_id 定位频道；subscriber_count 是订阅者数量，video_count / view_count 属于频道维度的统计值，不是本次视频样本数或单条视频播放量。
  • since 和 sort 影响用来取得资料的频道内容，不提供历史时点的订阅量。资料依赖可取得的频道内容，空内容或缺失字段不等于账号不存在；created_at 保留来源日期形式，不保证统一时间戳。这里不返回订阅者身份名单。

读取 YouTube 单条视频的标题、描述与互动数

用 video 定位一个作品，不因目录出现筛选项就当成另一轮搜索。

查看 video 的 url 参数 →
  • url 填 watch?v= 或视频分享地址。title / text 是标题与描述，字幕需另用 transcript；duration 没有统一秒数转换，解析时应保留单位与原始格式。author_url 指向频道，不是媒体下载地址。
  • 支持的筛选参数包含 date_range、duration、since、sort，但当前单视频模式下这些筛选参数未被证实有效，不能用作片段裁剪、字幕长度或内容排序。comment_count 只表示计数，阅读评论需要调用 comments；此接口不提供下载文件或创作者后台统计。

读取 YouTube 视频评论并保留回复关系

用 comments 处理评论区，不把热门顺序当作全部观众意见。

查看 comments 的 sort 参数 →
  • url 定位视频；sort 用 popular 表示热门评论、newest 表示最新评论，since 是评论日期下界，不是视频发布时间。返回 is_reply / reply_to_id 时可关联回复；reply_count 不是已完整取得的回复数量。
  • posted_at 可能是相对时间文字或日期原值，并未统一为 ISO 时间；不要直接拿它跨时区计算精确发布时间。author_name 只是显示名，当前结果没有作者频道 ID，不能仅据同名认定同一个人；评论缺失也可能由可见性限制导致。

频道视频选题观察

用频道 URL 读取视频列表，比较选题与发布节奏。

查看 user_posts 的 url 参数 →
  • 结合 title、posted_at、duration 与 view_count 整理内容表现。
  • 播放数不等于独立观众数；此接口不提供 YouTube Studio 私有分析。

视频文稿摘要与检索

读取具体视频的可用文稿，为自己的摘要或检索流程提供文本。

查看 transcript 的 language 参数 →
  • transcript 使用视频 URL，text 是文稿正文，segments 可用于关联片段。
  • 字幕语言取决于可用内容，不保证自动翻译；摘要与检索需自行实现。

频道 Shorts 内容对比

按频道 handle 读取 Shorts，单独分析短视频选题。

查看 shorts 的 username 参数 →
  • 使用 username 作为频道 handle，结合 title、duration 与 view_count 比较实际结果。
  • shorts 不是按关键词搜索全站短视频，也不保证完整历史覆盖。

频道订阅数量观察

定期查询频道 handle 的订阅数量，建立自己的观察记录。

查看 followers 的 username 参数 →
  • followers 的 follower_count 表示数量，比较时也要保留 precision。
  • 它不返回订阅者名单；定时调用、历史保存与变化告警需自行实现。

YouTube API 常见问题

YouTube API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="youtube"、action 和 params。以 search 为例，必填 keyword，可选 sort。这里检索视频主题；频道资料、字幕和评论使用各自目标。 YouTube 共 8 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

YouTube API 怎么收费？

$0.56 / 千次，YouTube 全部 8 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,798 次 YouTube 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

YouTube API 一次能返回多少条数据？

YouTube 有 4 个列表接口，包括 search、user_posts、comments、shorts。其余 4 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

YouTube API 返回哪些字段？

当前目录为 search 列出 id、url、title、text、author_name、author_username 等 14 个字段名。按全站当前目录统计，1 个字段名只在 YouTube 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按主题和排序发现 YouTube 视频」怎样接入 YouTube API？

用 search 搜索视频候选，再用具体视频或频道地址继续读取。 keyword 是视频检索词；sort 可填 relevance 相关性、newest 最近发布、most_viewed 播放量或 top_rated 评分排序。它不是频道搜索、播放列表搜索或带日期边界的全量归档，当前公开参数也没有任意起止日期。 author_id / author_url 定位发布频道，不是视频本身；duration 保留实际返回格式，不能一律当成秒数。计数与描述可能缺失，搜索摘要不是字幕全文，也不应把单次结果名次解释为官方权威排名。

「核对 YouTube 频道资料，而不是把视频计数当频道计数」怎样接入 YouTube API？

用 profile 读取频道内容所携带的资料，返回一个频道对象。 url 填频道页，而不是 watch 视频页。channel_id 定位频道；subscriber_count 是订阅者数量，video_count / view_count 属于频道维度的统计值，不是本次视频样本数或单条视频播放量。 since 和 sort 影响用来取得资料的频道内容，不提供历史时点的订阅量。资料依赖可取得的频道内容，空内容或缺失字段不等于账号不存在；created_at 保留来源日期形式，不保证统一时间戳。这里不返回订阅者身份名单。

「读取 YouTube 单条视频的标题、描述与互动数」怎样接入 YouTube API？

用 video 定位一个作品，不因目录出现筛选项就当成另一轮搜索。 url 填 watch?v= 或视频分享地址。title / text 是标题与描述，字幕需另用 transcript；duration 没有统一秒数转换，解析时应保留单位与原始格式。author_url 指向频道，不是媒体下载地址。 支持的筛选参数包含 date_range、duration、since、sort，但当前单视频模式下这些筛选参数未被证实有效，不能用作片段裁剪、字幕长度或内容排序。comment_count 只表示计数，阅读评论需要调用 comments；此接口不提供下载文件或创作者后台统计。

「读取 YouTube 视频评论并保留回复关系」怎样接入 YouTube API？

用 comments 处理评论区，不把热门顺序当作全部观众意见。 url 定位视频；sort 用 popular 表示热门评论、newest 表示最新评论，since 是评论日期下界，不是视频发布时间。返回 is_reply / reply_to_id 时可关联回复；reply_count 不是已完整取得的回复数量。 posted_at 可能是相对时间文字或日期原值，并未统一为 ISO 时间；不要直接拿它跨时区计算精确发布时间。author_name 只是显示名，当前结果没有作者频道 ID，不能仅据同名认定同一个人；评论缺失也可能由可见性限制导致。

可以先免费试用 YouTube API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 YouTube 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 8 个能力。无需信用卡。

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 YouTube API

加微信领 $1 免费额度，先选一个 YouTube 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始