使用 YouTube 数据 API

您需要提取 YouTube 视频元数据，获取最新评论，并推荐相关视频，而不必花费一周时间处理身份验证或分散的文档。在本指南结束时，您将能够查询给定视频 ID 的相似视频，获取评论，并使用 Zyla API Hub 上的 YouTube 数据 API 检索视频详细信息，提供可复制的请求和适合生产的提示。

此 API 的功能及使用时机

Zyla 上的 YouTube 数据 API 为媒体应用提供了三项专注的功能：

• 相似视频：通过传递 YouTube 视频 ID 获取相关视频列表。适用于“接下来播放”轮播或内容推荐。
• 视频评论：获取最新的顶级评论，包括作者、点赞和时间戳。适用于审核队列、情感管道或社区仪表板。
• 视频详细信息：检索规范元数据，如标题、描述、发布日期和参与度指标。适用于数据摄取、索引和预览用户界面。

这些端点针对常见的娱乐和媒体工作流程，例如构建观看下一个的提要、填充目录详细信息和分析观众反馈。

在 Zyla API Hub 上开始

打开 API 页面，订阅，并使用单个 API 密钥调用它。Zyla API Hub 提供一个帐户、一个 API 密钥，以及跨媒体 API 的订阅 + 配额模型（不是按调用付费）。对于您的第一个 API，您将看到 7 天的试用或 50 次请求；没有免费计划。请查看 API 页面以获取当前访问选项和定价。当准备好时，请在此处订阅并获取您的密钥：

开始 7 天的 YouTube 数据 API 试用

所有请求都使用 Authorization: Bearer YOUR_API_KEY 头部针对 Zyla 的中心 URL。您无需为每个提供者管理不同的身份验证方案。

您将使用的端点

以下是此列表中可用的三个端点，包括它们的确切 HTTP 方法、URL 和所需参数。请保持 URL 和参数名称与所示完全相同。

1) 相似视频

接收相关视频的列表。传递视频 ID 并获取与之最相似的视频。

• 方法：GET
• URL：https://zylalabs.com/api/14/youtube-data-api/56/similar-videos
• 所需参数：
  • relatedToVideoId (字符串)：7ghhRHRP6t4
  • part (字符串)：id,snippet
  • type (字符串)：video
• 可选参数：
  • maxResults (字符串)：50

官方 cURL 示例：

curl -s -X GET "https://zylalabs.com/api/14/youtube-data-api/56/similar-videos?relatedToVideoId=7ghhRHRP6t4&part=id%2Csnippet&type=video&maxResults=50" \
-H "Authorization: Bearer YOUR_API_KEY"

官方示例 JSON 响应：

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"Ed Sheeran - Beautiful People (feat. @khalid) 的官方音乐视频
Subtract，新专辑，将于 2023 年 5 月 5 日发布。预购： https://es.lnk.to/subtract

取自 2019 年发布的 No.6 Collaborations Project，其中包含热门单曲 ‘I Don’t Care’, ‘Cross Me’, ‘Beautiful People’, ‘Blow’, ‘Best Part of Me’, ‘Antisocial’, ‘South of the Border’ &‘Take Me Back To London’。

订阅 Ed Sheeran 频道，获取所有最佳和最新的官方音乐视频、幕后花絮和现场表演。 
http://bit.ly/SubscribeToEdSheeran

在此查看 Ed Sheeran 的更多官方视频：
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

在此收听更多来自 No. 6 Collaborations Project 的内容：
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

在以下平台关注 Ed Sheeran：
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
官方网站: http://edsheeran.com

关于 Ed Sheeran：
Ed Sheeran 可能是 2010 年代的典型流行明星：一位国际知名、多次获奖的歌手/词曲创作人，似乎在风格或时代之间没有界限，他的音乐中融入了民谣、嘻哈、流行、舞曲、灵魂和摇滚等元素。

他令人难以置信的目录包括录音室专辑 ‘+’ (plus)、‘x’ (multiply) 和 ‘÷’ (divide)，这些专辑产生了热门单曲，如 ‘The A team’ , ’Lego House’, ‘Sing’, ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ 和 ‘Perfect’。

在 2019 年，Ed Sheeran 发布了跨流派的 ‘No.6 Collaborations Project’，其中包括许多艺术家，如 ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ 和 ‘Stormzy’ 等，制作了如 ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ 和 ‘Take Me Back To London’ 等热门歌曲。

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

您在实践中将使用的内容：

• items[].id.videoId：相关视频的 ID（字符串）。
• items[].snippet.title：您 UI 的显示标题。
• items[].snippet.publishedAt：ISO 8601 时间戳（Z = UTC）。
• nextPageToken：在后续调用中传回此令牌（作为页面令牌，当支持时）以分页获取更多结果。

2) 视频评论

获取有关特定视频的最新评论列表。您将收到评论文本、作者信息、点赞和创建/更新时间戳。

• 方法：GET
• URL：https://zylalabs.com/api/14/youtube-data-api/61/video-comments
• 所需参数：
  • part (字符串)：snippet
  • videoId (字符串)：7ghhRHRP6t4
  • maxResults (字符串)：100

从响应中读取的典型字段：

• items[].snippet.topLevelComment.snippet.textDisplay 或 textOriginal：评论正文。
• items[].snippet.topLevelComment.snippet.authorDisplayName：评论者的显示名称。
• items[].snippet.topLevelComment.snippet.likeCount：整数点赞数。
• items[].snippet.topLevelComment.snippet.publishedAt 和 updatedAt：ISO 8601 UTC 时间。
• nextPageToken：如果提供，则继续分页。

3) 视频详细信息

获取任何视频的详细信息：标题、描述、发布日期和参与计数。

• 方法：GET
• URL：https://zylalabs.com/api/14/youtube-data-api/62/video-details
• 所需参数：
  • id (字符串)：7ghhRHRP6t4

从响应中读取的典型字段：

• items[].snippet.title 和 items[].snippet.description 用于显示和索引。
• items[].snippet.publishedAt 用于时间顺序和过滤。
• 其他统计字段可能会根据上游提供者的不同而存在；请参考您收到的有效负载。

Python 示例：获取和渲染相关视频

此 Python 代码片段调用相似视频端点，提取 videoId 和标题以渲染观看下一个列表，并展示如何通过 nextPageToken 处理分页。

import requests

API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/14/youtube-data-api/56/similar-videos"
params = {
"relatedToVideoId": "7ghhRHRP6t4",
"part": "id,snippet",
"type": "video",
"maxResults": "50",
}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

# 提取 UI 的项目
items = data.get("items", [])
related = []
for item in items:
vid = ((item or {}).get("id") or {}).get("videoId")
title = ((item or {}).get("snippet") or {}).get("title")
if vid and title:
related.append({"videoId": vid, "title": title})

print(f"获取到 {len(related)} 个相关视频：")
for r in related[:5]:
print(f"- {r['videoId']}: {r['title']}")

# 如果 nextPageToken 存在，则处理分页（在支持时将其作为页面令牌传递）
next_token = data.get("nextPageToken")
if next_token:
print("更多页面可通过 nextPageToken 获取：", next_token)

您本周可以发布的真实媒体用例

• 观看下一个和推荐：使用相似视频为您的应用或嵌入式播放器 UI 中的“因为您观看了 X”提供种子。
• 视频详细信息页面：使用视频详细信息填充主元数据；缓存 JSON 响应以减少重复提取。
• 社区和审核：将视频评论输入审核队列或简单的“最近评论”小部件；存储 authorDisplayName、textOriginal、likeCount 和时间戳。
• 编辑策划：构建内部工具，编辑者粘贴视频 ID 并立即获取相关内容以构建集合。
• 通知和警报：监控高优先级视频的评论（以合理的间隔轮询）并提醒创作者或支持团队。

节省时间的实施说明

• 时间戳：publishedAt 和 updatedAt 字段是带有尾随 Z 的 ISO 8601 字符串，表示 UTC。一次转换并在您的服务中进行标准化。
• 分页：如果响应中存在 nextPageToken，请捕获它并发出后续请求以检索其他结果。不要假设所有结果都适合一页。
• maxResults：在需要更少往返时保持为 50；在初始渲染需要快速的轻量级 UI 中减少它。
• 缓存：缓存稳定视频的视频详细信息以减少延迟和配额使用。对于评论，应用较短的缓存窗口，因为新评论频繁到达。
• 错误处理：将非 2xx 响应视为瞬态或权限相关问题。记录请求 URL 和状态；避免重试风暴。
• 安全性：在服务器端使用 Authorization: Bearer YOUR_API_KEY 头部。避免在客户端代码中暴露您的 API 密钥。

如何从 AI 代理调用它（MCP）

如果您正在使用 MCP 兼容客户端（例如 Claude Code、Cursor、Windsurf）协调任务，您可以通过 Zyla 的 MCP 端点路由调用并重用相同的密钥。请查阅 MCP 文档并配置您的客户端指向：

MCP

按照您的 MCP 客户端的配置传递您的 API 密钥（apikey=YOUR_API_KEY 在端点 URL 中）。从那里，您的代理可以调用中心公开的 YouTube 数据 API 工具，而无需手动编码 HTTP 调用。这对于脚本化内容策划或临时数据提取非常有帮助。

参考：确切的请求和字段

相似视频

GET https://zylalabs.com/api/14/youtube-data-api/56/similar-videos

• relatedToVideoId（必需）
• part（必需）
• type（必需）
• maxResults（可选）

主要读取字段：

• items[].id.videoId
• items[].snippet.title
• items[].snippet.publishedAt
• nextPageToken

视频评论

GET https://zylalabs.com/api/14/youtube-data-api/61/video-comments

• part（必需）
• videoId（必需）
• maxResults（必需）

主要读取字段：

• items[].snippet.topLevelComment.snippet.textDisplay
• items[].snippet.topLevelComment.snippet.authorDisplayName
• items[].snippet.topLevelComment.snippet.likeCount
• items[].snippet.topLevelComment.snippet.publishedAt
• nextPageToken（如果存在）

视频详细信息

GET https://zylalabs.com/api/14/youtube-data-api/62/video-details

• id（必需）

主要读取字段：

• items[].snippet.title
• items[].snippet.description
• items[].snippet.publishedAt

媒体应用的操作指导

• 吞吐量规划：Zyla 使用订阅 + 配额模型，而不是按调用付费。您的第一个 API 包括 7 天的试用或 50 次请求。对于更高的使用量，请监控您的使用情况，并查看 API 页面以获取当前选项。
• 数据新鲜度：评论变化迅速；视频详细信息变化较少。相应调整您的缓存 TTL。
• 索引策略：将稳定标识符（videoId）存储为外键，并将标题/描述去规范化以支持搜索和快速渲染。
• 弹性：在 429/5xx 响应上应用退避。记录使用的端点和参数以加速调试。
• 国际化：标题和描述可能包含 Unicode 和 HTML 实体。根据您的 UI 框架进行规范化和转义。

常见问题解答

问：我使用什么身份验证？
答：在每个请求中使用 Authorization: Bearer YOUR_API_KEY 头部访问 Zyla 中心 URL。

问：有没有免费计划？
答：没有免费计划。对于您的第一个 API，您将看到 7 天的试用或 50 次请求。请查看 API 页面以获取当前访问选项和定价。

问：我如何分页结果？
答：从响应中读取 nextPageToken。当存在时，再次调用端点并将该令牌作为页面令牌传递（在支持时）以获取下一页。

问：我应该期待哪些时间戳和时区？
答：时间戳，如 publishedAt 和 updatedAt，是带有 Z 后缀的 ISO 8601 字符串，表示 UTC。

问：我可以从我的 AI 编码代理调用这个吗？
答：可以，通过 Zyla 的 MCP 端点。配置您的 MCP 兼容客户端以使用 MCP URL 和您的 API 密钥，以便代理可以调用 YouTube 数据 API 工具，而无需手动 HTTP 代码。

准备好发布您的媒体集成了吗？订阅并从市场列表中获取您的 API 密钥： 开始 7 天的 YouTube 数据 API 试用。探索更多数千个媒体 API，并在 Zyla API Hub 上更快发布。

官方 API 响应

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"Ed Sheeran - Beautiful People (feat. @khalid) 的官方音乐视频
Subtract，新专辑，将于 2023 年 5 月 5 日发布。预购： https://es.lnk.to/subtract

取自 2019 年发布的 No.6 Collaborations Project，其中包含热门单曲 ‘I Don’t Care’, ‘Cross Me’, ‘Beautiful People’, ‘Blow’, ‘Best Part of Me’, ‘Antisocial’, ‘South of the Border’ &‘Take Me Back To London’。

订阅 Ed Sheeran 频道，获取所有最佳和最新的官方音乐视频、幕后花絮和现场表演。 
http://bit.ly/SubscribeToEdSheeran

在此查看 Ed Sheeran 的更多官方视频：
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

在此收听更多来自 No. 6 Collaborations Project 的内容：
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

在以下平台关注 Ed Sheeran：
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
官方网站: http://edsheeran.com

关于 Ed Sheeran：
Ed Sheeran 可能是 2010 年代的典型流行明星：一位国际知名、多次获奖的歌手/词曲创作人，似乎在风格或时代之间没有界限，他的音乐中融入了民谣、嘻哈、流行、舞曲、灵魂和摇滚等元素。

他令人难以置信的目录包括录音室专辑 ‘+’ (plus)、‘x’ (multiply) 和 ‘÷’ (divide)，这些专辑产生了热门单曲，如 ‘The A team’ , ’Lego House’, ‘Sing’, ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ 和 ‘Perfect’。

在 2019 年，Ed Sheeran 发布了跨流派的 ‘No.6 Collaborations Project’，其中包括许多艺术家，如 ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ 和 ‘Stormzy’ 等，制作了如 ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ 和 ‘Take Me Back To London’ 等热门歌曲。

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

官方 API 响应

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"Ed Sheeran - Beautiful People (feat. @khalid) 的官方音乐视频
Subtract，新专辑，将于 2023 年 5 月 5 日发布。预购： https://es.lnk.to/subtract

取自 2019 年发布的 No.6 Collaborations Project，其中包含热门单曲 ‘I Don’t Care’, ‘Cross Me’, ‘Beautiful People’, ‘Blow’, ‘Best Part of Me’, ‘Antisocial’, ‘South of the Border’ &‘Take Me Back To London’。

订阅 Ed Sheeran 频道，获取所有最佳和最新的官方音乐视频、幕后花絮和现场表演。 
http://bit.ly/SubscribeToEdSheeran

在此查看 Ed Sheeran 的更多官方视频：
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

在此收听更多来自 No. 6 Collaborations Project 的内容：
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

在以下平台关注 Ed Sheeran：
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
官方网站: http://edsheeran.com

关于 Ed Sheeran：
Ed Sheeran 可能是 2010 年代的典型流行明星：一位国际知名、多次获奖的歌手/词曲创作人，似乎在风格或时代之间没有界限，他的音乐中融入了民谣、嘻哈、流行、舞曲、灵魂和摇滚等元素。

他令人难以置信的目录包括录音室专辑 ‘+’ (plus)、‘x’ (multiply) 和 ‘÷’ (divide)，这些专辑产生了热门单曲，如 ‘The A team’ , ’Lego House’, ‘Sing’, ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ 和 ‘Perfect’。

在 2019 年，Ed Sheeran 发布了跨流派的 ‘No.6 Collaborations Project’，其中包括许多艺术家，如 ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ 和 ‘Stormzy’ 等，制作了如 ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ 和 ‘Take Me Back To London’ 等热门歌曲。

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…