Когда рабочий процесс начинается с создателя, а не с видео URL, сначала извлеките канал и его последние видео. Это дает вам ограниченный список видео IDs для более поздних запросов метаданных или подписей. Это руководство сохраняет снимок канала и простой файл ID, используя стандартную библиотеку Python.
Что возвращает конечная точка канала
The youtube_channel Источник принимает ручку, такую как @jawed; а @ Префикс необязательный. params.video_limit Контролирует количество недавних записей для запроса, от 1 до 100, с по умолчанию 20. Меньше видео может быть доступно.
Возвращенный videoCount Описывается общее количество видео на канале. The videos массив содержит последние записи, возвращенные этим запросом. Запрос на записи 20 не извлекает весь архив канала, и эта конечная точка не предлагает документированный параметр страницы для просмотра всех исторических загрузок.
Статистика каналов и изображения могут отсутствовать или null. Сохраняйте это различие в своих данных: недоступное количество подписчиков не является каналом с нулевым числом подписчиков.
Установите ручку и небольшой лимит сбора
Создать Ключ API Имеющиеся кредиты. Начните с небольшого ограничения, чтобы проверить ответ, прежде чем планировать больший рабочий процесс. Получение данных канала и более поздние извлечения метаданных каждого видео являются отдельными запросами API.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
Сохранить канал снимка и видео IDs
Сохранить этот код как channel-videos.py. Сценарий проверяет завершенность ответа, извлекает действительное видео IDs и сохраняет исходные видеозаписи в 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
Используйте IDs для целенаправленного последующего запроса
Реакция канала содержит компактные видеозаписи: IDs, заголовки, продолжительность, количество просмотров, даты загрузки и миниатюры, когда они доступны. Для получения дополнительной информации отправьте один из этих IDs в youtube_metadata. Прочтите ID из сохраненного файла, а не пытаться разобрать его по заголовку или миниатюре URL.
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}
Отправьте это тело в ту же конечную точку в реальном времени. Заполнитель должен быть заменен фактическим 11-символом ID. Если вам нужны подписи, используйте Языковое руководство Решить, какой путь приемлем, прежде чем подавать запрос.
План многократного сбора и больших рабочих нагрузок
Храните видео IDs, которое вы уже обработали. Сравните будущие снимки с этим набором, чтобы избежать повторной отправки одной и той же работы.
Сохраняйте время сбора с помощью собственных снимков. Графики могут меняться, и видео может стать недоступным после того, как оно появилось в ответе канала.
Ограниченный снимок недавнего видео может пропустить старые загрузки или элементы между нечастыми запусками. Не описывайте его как полный архив или как один раз.
Для нескольких запросов вниз по течению выберите обработку асинхронной или пакетной обработки в пределах вашего плана. Отправка групп пакетов; это не делает каждый пункт бесплатным или устраняет необходимость получения результатов работы.
Видишь? Канал API ссылка, Метаданные видео API и Async и пакетный гид. Для поиска первого рабочего процесса, исследуйте Добавление поисковых инструментов к агенту ИИ.