如果工作流从创作者而非视频 URL 开始,请先获取频道及其近期视频。这样便能得到数量有限的视频 ID 列表,用于后续元数据或字幕请求。本教程使用 Python 标准库保存频道快照和简单的 ID 文件。
频道端点返回什么
该 youtube_channel 数据源接受账号句柄,例如 @jawed; @ 前缀为可选项。 params.video_limit 控制请求的近期条目数,范围为 1 到 100,默认值为 20。实际可用视频可能更少。
返回的 videoCount 描述频道的视频总数。 videos 数组包含本次请求返回的近期条目。请求 20 条不会获取频道的全部历史内容,此端点也没有文档所列的分页参数可用于遍历所有历史上传内容。
频道统计信息和图片可能缺失或为 null。请在数据中保留这一区别:订阅者数量不可用,不等于频道没有订阅者。
设置频道标识名和较小的采集数量上限
创建一个 API 密钥 ,并确保有可用积分。先使用较小的限额查看响应,再规划更大的工作流程。获取频道数据和随后获取每个视频的元数据是独立的 API 请求。
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
保存频道快照和视频 ID
将此代码保存为 channel-videos.py。脚本会检查响应是否完成,提取有效视频 ID,并以 JSON 保留原始视频记录。每个唯一 ID 只写入一次,即使数据源响应中包含重复条目。
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"))
python3 channel-videos.py
使用这些 ID 发起有针对性的后续请求
频道响应包含精简的视频记录:ID、标题、时长、观看次数、上传日期,以及可用的缩略图。如需更多详情,请将其中一个 ID 提交到 youtube_metadata。从已保存的文件读取 ID,不要尝试从标题或缩略图 URL 中解析 ID。
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}
将该请求体发送到同一个实时端点。必须将占位符替换为实际的 11 字符 ID。如果需要字幕,请改用 字幕语言指南 ,在提交请求前确定可接受的字幕轨道。
规划定期采集和更大规模的工作负载
保存已处理的视频 ID。将后续快照与该 ID 集合进行比较,避免重复提交相同的下游任务。
请将采集时间随自有快照一同保存。计数可能变化,视频出现在频道响应后也可能变得不可用。
范围有限的近期视频快照可能遗漏较早上传的内容,或漏掉低频运行间隔中的条目。不要将其描述为完整归档或保证恰好一次的事件流。
对于多个下游请求,请在套餐限额内选择异步或批量请求处理。批量请求只是将提交组合在一起;并不代表各项免费,也不免除获取任务结果的步骤。
参见 Channel API 参考文档, 视频元数据 API 和 异步与批量请求指南。如需先搜索再处理的流程,请查看 为 AI 智能体添加搜索工具.