每个频道的视频 API

您需要在本周回答一个具体的问题：一个频道有多少个视频，或者哪些频道主导一个主题？在本文结束时，您将能够通过 Zyla API Hub 上的 Youtube Data API 以编程方式计算“每个频道的视频”，并获得可以按频道聚合的真实数据的可复制请求。

此 API 为您提供的内容（以及如何将其转化为“每个频道的视频”）

在 Zyla 上的 Youtube Data API 暴露了以下端点：

• 获取与种子视频相关的视频（每个项目包括频道 ID 和标题）。
• 获取视频的详细信息（包括其频道 ID、标题、描述和其他元数据）。
• 获取视频的最新评论（有助于质量信号或审核流程）。

通过按 snippet.channelId 分组返回的视频并计数，可以计算“每个频道的视频”。两个常见的流程可以快速完成，而无需额外的发现端点：

• 基于种子的主题覆盖：从已知视频开始，调用相似视频，然后计算每个频道来自多少相关视频。
• 已知列表计数：如果您已经有视频 ID 列表（例如，来自您的数据库、CSV 或活动），则为每个调用视频详细信息，读取 snippet.channelId，并按频道聚合计数。

本文展示了这两种流程，提供了精确的端点和字段，以便您可以自信地构建聚合。

在 Zyla API Hub 上入门

打开 Zyla 上的 Youtube Data API 页面。点击订阅或开始 7 天试用，您将获得一个可以与此 API 和其他 API 一起使用的单一 API 密钥。Zyla 是一个拥有超过 10,000 个公共 API 的市场，您只需一个帐户、一个密钥和一个订阅 + 配额模型（不是按调用计费）。没有免费计划；对于此 API，您可以直接在列表页面开始 7 天的试用。

• API 列表：在 Youtube Data API 上开始 7 天试用
• 浏览市场：https://zylalabs.com

身份验证：将您的密钥作为 Authorization: Bearer YOUR_API_KEY 发送在头部。以下所有示例都使用该头部。

您将用于计算每个频道视频的端点

1) 相似视频

接收给定视频 ID 的相关视频列表。每个项目包括 snippet.channelId 和 id.videoId，这正是您需要在相关集合中计算每个频道计数的内容。

• 方法：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 年代的典型流行明星：一位国际公认的、多次获奖的歌手/词曲创作人，他似乎在风格或时代之间没有界限，音乐中融入了民谣、嘻哈、流行、舞曲、灵魂和摇滚等元素。

他令人难以置信的曲目包括录音室专辑 ‘+’（加），‘x’（乘）和 ‘÷’（除），这些专辑产生了热门单曲，如 ‘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.channelId：发布视频的频道。
• pageInfo.resultsPerPage 和 nextPageToken：用于了解结果大小和是否存在更多结果。如果您需要更多页面，请查看 API 页面以获取分页使用。
• snippet.publishedAt：时间戳为 ISO 8601 格式，带 Z（UTC），这对于排序和窗口处理非常简单。

2) 视频详细信息

返回给定视频 ID 的详细信息。当您已经有视频 ID 列表以进行计数时，使用此方法来解析视频的频道和元数据。

• 方法：GET
• URL：https://zylalabs.com/api/14/youtube-data-api/62/video-details
• 所需参数：
  • id（字符串）：视频 ID（例如，7ghhRHRP6t4）

cURL：

从示例响应中，您将使用 items[].snippet.channelId 以及视频 id。

3) 视频评论

获取给定视频的最新评论。虽然不需要计算每个频道的计数，但此端点可以帮助您根据参与度优先考虑频道或审核与您展示的高流量频道相关的内容。

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

cURL：

通过单个请求计算“每个频道的视频”

当您没有频道发现端点时，最快的路径是从一个已知视频开始，该视频代表您的主题，并计算来自每个频道的相关视频数量。这通常足以：

• 找出哪些频道主导主题集群。
• 为推荐侧边栏构建建议的“顶级频道”。
• 预筛选要联系的频道以进行合作或包含在策划的供稿中。

Python 示例：从相似视频中计数频道

此脚本调用相似视频，按 snippet.channelId 分组，并返回按计数排序的频道列表。它使用来自中心列表的确切端点和参数。

import os
import requests
from collections import Counter

API_KEY = os.environ.get("ZYLALABS_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, headers=headers, params=params, timeout=30)
resp.raise_for_status()
data = resp.json()

# 按 channelId 聚合视频
channel_counts = Counter()
videos_by_channel = {}

for item in data.get("items", []):
snippet = item.get("snippet", {})
channel_id = snippet.get("channelId")
videos_id = item.get("id", {}).get("videoId")
title = snippet.get("title")
if channel_id and video_id:
channel_counts[channel_id] += 1
videos_by_channel.setdefault(channel_id, []).append({
"videoId": video_id,
"title": title
})

# 打印按计数排序的顶级频道
for channel_id, count in channel_counts.most_common():
print(f"{channel_id}: {count} videos")
# 可选地列出视频 ID 以构建链接或播放列表
for v in videos_by_channel[channel_id]:
print(f" - {v['videoId']} :: {v.get('title','')}")

# 注意：如果有更多结果，数据可能包括 'nextPageToken'。
# 在需要时请查阅 API 页面以获取额外页面的获取方法。

节省时间的实施说明：

• 计数反映您获取的切片。如果您想要更广泛的覆盖，请选择能很好代表您主题的种子视频，并在多个种子上重复聚合。
• publishedAt 是 UTC 的 ISO 8601 格式。您可以在计数之前过滤到一个时间窗口，以关注最近的活动。
• 如果存在 nextPageToken，则还有更多结果。请查看 API 页面以获取确切的分页使用方法以继续获取。
• 根据参数缓存每个请求的 JSON。为了快速迭代，持久化原始响应，并在本地重新运行聚合，而无需重新获取。

替代方案：统计已知的视频 ID 集（使用视频详细信息）

如果您已经有视频 ID 列表（例如，您跟踪的上传、活动链接或 CSV），则为每个调用视频详细信息以解析其 snippet.channelId，然后按频道计数。这将产生您输入集的确切每个频道的细分。

高级步骤：

1. 迭代您列表中的视频 ID。
2. 对于每个，GET https://zylalabs.com/api/14/youtube-data-api/62/video-details?id=VIDEO_ID。
3. 读取 items[0].snippet.channelId 并增加计数器。

提示：存储一个小的本地映射 {videoId: channelId}，以避免在开发期间对同一项目重新调用 API。

在排名频道时使用参与信号

一旦您有每个频道的计数，您可能想要超越纯粹的数量进行排名。一种轻量级的方法是从顶级频道的代表性视频中提取最近的评论，并使用 likeCount、publishedAt 或文本长度生成简单的启发式（例如，“最近高点赞评论的频道会得到轻微提升”）。视频评论端点返回：

• textOriginal 和 authorDisplayName：用于简单的 NLP 和归属。
• likeCount、publishedAt：用于快速评分和最近性窗口。

通过 MCP 从 AI 代理调用

如果您从 IDE 代理（Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端）进行协调，请使用 Zyla 的 MCP 端点。提供您的 API 密钥，让代理直接从您的编辑器调用中心端点。请在此处查看 MCP 入口点：MCP。相同的授权头在后台适用，每个工具调用映射到相应的 Zyla API 端点。如果您需要帐户密钥，请在 Zyla API Hub 上创建一个，然后将您的代理指向带有您的密钥的 MCP 端点。

操作提示

• 身份验证：始终包括 Authorization: Bearer YOUR_API_KEY。
• 配额和计费：Zyla 使用订阅 + 配额（不是按调用计费）。对于此 API，您可以从列表中开始 7 天试用。请查看 API 页面以获取当前访问选项和定价。
• 时间戳：像 publishedAt 这样的字段是 ISO 8601 UTC（Z）。在您的数据存储中规范化为 UTC。
• 分页：如果响应包含 nextPageToken，则存在更多结果。请参考 API 页面以根据需要继续分页；在构建批处理作业时持久化您的最后一个令牌。
• 去重：在跨多个种子视频聚合时，使用 id.videoId 作为去重的规范键。
• 部分响应：仅依赖于示例中显示的字段或 API 文档中指定的字段。在您的代码中防御性地处理缺失字段。

端到端示例工作流程

目标：在没有专用频道列表端点的情况下，为给定主题生成频道排行榜。

1. 为该主题选择 3-5 个代表性种子视频（例如，每个子主题一个）。
2. 对于每个种子，调用相似视频，使用 part=id,snippet 和 type=video。将 maxResults 保持在 50 以获取广度。缓存原始 JSON 文件。
3. 合并所有项目，按 snippet.channelId 分组并计数。
4. 可选地，对于前 N 个频道，抽样 1-2 个视频并调用视频评论以收集快速参与提示。
5. 渲染：频道 ID 和视频计数；可选地列出每个频道的一些代表性视频。

为什么这能快速实现“每个频道的视频”

您正在处理直接从每个视频的片段返回的频道 ID。计算它们非常简单，并且避免了多步骤的发现。如果您的产品确实需要每个频道的总公共上传（即完整目录大小），请使用更广泛的种子覆盖，并在几个已知锚点上重复相似视频获取；然后持久化并随时间去重。对于许多用例（策划、推荐、外展），主题集群中的相对数量是您想要的，而这种方法通过一次请求和小规模聚合提供了它。

参考：一个地方的端点详细信息

相似视频

• GET https://zylalabs.com/api/14/youtube-data-api/56/similar-videos
• 参数：
  • relatedToVideoId（必需）：7ghhRHRP6t4
  • part（必需）：id,snippet
  • type（必需）：video
  • maxResults（可选）：50

视频详细信息

• GET https://zylalabs.com/api/14/youtube-data-api/62/video-details
• 参数：
  • id（必需）：7ghhRHRP6t4

视频评论

• GET https://zylalabs.com/api/14/youtube-data-api/61/video-comments
• 参数：
  • part（必需）：snippet
  • videoId（必需）：7ghhRHRP6t4
  • maxResults（必需）：100

常见问题

我该如何进行身份验证？
将您的密钥发送在头部：Authorization: Bearer YOUR_API_KEY。

我可以获取超过 50 个相关视频吗？
当存在更多结果时，响应会显示 nextPageToken。请查看 API 页面以了解如何在第一页之后继续分页。

哪些字段标识频道和视频？
使用 items[].id.videoId 作为视频标识，使用 items[].snippet.channelId 作为频道标识。

有免费计划吗？
没有免费计划。您可以从 API 列表开始 7 天试用。请查看 API 页面以获取当前访问选项和定价。

我可以从 AI 代理调用这个吗？
可以。使用 Zyla 的 MCP 端点和您的 API 密钥，让兼容 MCP 的客户端调用相同的端点。

准备好发布您的“每个频道的视频”聚合了吗？在列表上开始您的 7 天试用并获取您的 API 密钥：Zyla 上的 Youtube Data API。一个密钥可以在整个中心使用，因此您可以随着进展扩展您的集成。

官方 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 年代的典型流行明星：一位国际公认的、多次获奖的歌手/词曲创作人，他似乎在风格或时代之间没有界限，音乐中融入了民谣、嘻哈、流行、舞曲、灵魂和摇滚等元素。

他的令人难以置信的曲目包括录音室专辑 ‘+’（加），‘x’（乘）和 ‘÷’（除），这些专辑产生了热门单曲，如 ‘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":{"…