跳转到正文
中文
获取 API 密钥

YouTube 数据 / Python

使用 Python 获取 YouTube 频道的最新视频

通过标识名读取 YouTube 频道,导出近期视频 ID 和元数据,并区分返回的视频列表与频道的视频总数。

FlashData · 发布于

频道资料连接着一排近期视频卡片

如果工作流从创作者而非视频 URL 开始,请先获取频道及其近期视频。这样便能得到数量有限的视频 ID 列表,用于后续元数据或字幕请求。本教程使用 Python 标准库保存频道快照和简单的 ID 文件。

频道端点返回什么

该 youtube_channel 数据源接受账号句柄,例如 @jawed; @ 前缀为可选项。 params.video_limit 控制请求的近期条目数,范围为 1 到 100,默认值为 20。实际可用视频可能更少。

返回的 videoCount 描述频道的视频总数。 videos 数组包含本次请求返回的近期条目。请求 20 条不会获取频道的全部历史内容,此端点也没有文档所列的分页参数可用于遍历所有历史上传内容。

频道统计信息和图片可能缺失或为 null。请在数据中保留这一区别:订阅者数量不可用,不等于频道没有订阅者。

设置频道标识名和较小的采集数量上限

创建一个 API 密钥 ,并确保有可用积分。先使用较小的限额查看响应,再规划更大的工作流程。获取频道数据和随后获取每个视频的元数据是独立的 API 请求。

bash
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'

保存频道快照和视频 ID

将此代码保存为 channel-videos.py。脚本会检查响应是否完成,提取有效视频 ID,并以 JSON 保留原始视频记录。每个唯一 ID 只写入一次,即使数据源响应中包含重复条目。

python
import json
import os
import re
from pathlib import Path
from urllib.request import Request, urlopen
from urllib.error import HTTPError

key = os.environ["FLASHDATA_API_KEY"]
handle = os.environ.get("YOUTUBE_HANDLE", "@jawed").strip()
limit = int(os.environ.get("VIDEO_LIMIT", "20"))
if not handle or len(handle) > 100:
    raise ValueError("Use a channel handle of at most 100 characters")
if not 1 <= limit <= 100:
    raise ValueError("VIDEO_LIMIT must be between 1 and 100")
request = Request(
    "https://data.flashdata.dev/v1/queries/realtime",
    data=json.dumps({"source": "youtube_channel", "handle": handle,
                     "params": {"video_limit": limit}}).encode(),
    method="POST", headers={"Content-Type": "application/json", "X-API-Key": key},
)
try:
    with urlopen(request, timeout=60) as response:
        payload = json.load(response)
except HTTPError as error:
    raise RuntimeError(f"Channel request failed: HTTP {error.code}") from error
if payload.get("error") or payload.get("status") != "done":
    raise RuntimeError("Channel request did not complete. Check Request History before retrying.")
if not isinstance(payload.get("results"), list) or not payload["results"]:
    raise RuntimeError("Expected a channel result")
channel = payload["results"][0]
videos = channel.get("videos")
if not isinstance(videos, list):
    raise RuntimeError("Expected a videos array")
ids = list(dict.fromkeys(
    row["videoId"] for row in videos
    if isinstance(row.get("videoId"), str)
    and re.fullmatch(r"[A-Za-z0-9_-]{11}", row["videoId"])
))
Path("channel.json").write_text(json.dumps({
    "requestedHandle": handle, "requestedLimit": limit,
    "channel": channel, "usage": payload.get("usage"),
}, indent=2), encoding="utf-8")
Path("video-ids.txt").write_text("".join(video_id + "\n" for video_id in ids), encoding="utf-8")
print(f"Saved {len(videos)} returned entries and {len(ids)} unique video IDs")
print("Reported channel video count:", channel.get("videoCount"))
bash
python3 channel-videos.py

使用这些 ID 发起有针对性的后续请求

频道响应包含精简的视频记录:ID、标题、时长、观看次数、上传日期,以及可用的缩略图。如需更多详情,请将其中一个 ID 提交到 youtube_metadata。从已保存的文件读取 ID,不要尝试从标题或缩略图 URL 中解析 ID。

json
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}

将该请求体发送到同一个实时端点。必须将占位符替换为实际的 11 字符 ID。如果需要字幕,请改用 字幕语言指南 ,在提交请求前确定可接受的字幕轨道。

规划定期采集和更大规模的工作负载

  • 保存已处理的视频 ID。将后续快照与该 ID 集合进行比较,避免重复提交相同的下游任务。

  • 请将采集时间随自有快照一同保存。计数可能变化,视频出现在频道响应后也可能变得不可用。

  • 范围有限的近期视频快照可能遗漏较早上传的内容,或漏掉低频运行间隔中的条目。不要将其描述为完整归档或保证恰好一次的事件流。

  • 对于多个下游请求,请在套餐限额内选择异步或批量请求处理。批量请求只是将提交组合在一起;并不代表各项免费,也不免除获取任务结果的步骤。

参见 Channel API 参考文档, 视频元数据 API 和 异步与批量请求指南。如需先搜索再处理的流程,请查看 为 AI 智能体添加搜索工具.