Cuando un flujo de trabajo comienza con un creador en lugar de un video URL, primero recuperar el canal y sus videos recientes. Eso le da una lista de vídeo IDs para posteriores solicitudes de metadatos o captura. Este tutorial ahorra una instantánea del canal y un simple archivo ID usando la biblioteca estándar de Python.
Lo que el punto final del canal devuelve
El youtube_channel fuente acepta un mango como @jawed; el @ prefijo es opcional. params.video_limit controla cuántas entradas recientes para solicitar, desde 1 a 100, con un predeterminado de 20.
Los devueltos videoCount describe el número total de vídeo del canal. videos array contiene las entradas recientes devueltas por esta solicitud. Una solicitud para las entradas de 20 no recupera todo el archivo del canal, y este punto final no ofrece un parámetro de página documentado para caminar todas las cargas históricas.
Las estadísticas de canales y las imágenes pueden faltar o nulas. Mantenga esa distinción en sus datos: un recuento de suscriptores no disponible no es un canal con cero suscriptores.
Establecer el mango y un pequeño límite de colección
Crear un Clave API con Créditos disponibles. Comience con un pequeño límite para inspeccionar la respuesta antes de planificar un flujo de trabajo más grande. Los datos de canales de captura y más tarde buscar los metadatos de cada vídeo son solicitudes API separadas.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
Guardar la instantánea del canal y el vídeo IDs
Guardar este código como channel-videos.py. El script comprueba que la respuesta completada, extrae vídeo válido IDs, y preserva los archivos de vídeo originales en JSON. Escribe cada uno único ID una vez, incluso si una respuesta fuente contiene una entrada duplicada.
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
Utilice el IDs para una solicitud de seguimiento enfocada
La respuesta del canal contiene registros de vídeo compactos: IDs, títulos, duración, cuenta de vista, fechas de carga y miniaturas cuando esté disponible. Para más detalles, envíe uno de esos IDs a youtube_metadata. Lea el ID del archivo guardado en lugar de tratarlo de un título o miniatura URL.
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}
Envíe ese cuerpo al mismo punto final en tiempo real. El titular del lugar debe ser reemplazado por un 11-character ID. Si necesita capciones en su lugar, utilice el caption language guide decidir qué pista es aceptable antes de presentar una solicitud.
Plan repetida colección y mayores cargas de trabajo
Almacene el vídeo IDs que ya ha procesado. Compare las instantáneas futuras con ese conjunto para evitar enviar el mismo trabajo aguas abajo repetidamente.
Mantenga el tiempo de recogida con sus propias instantáneas. Los condes pueden cambiar y un vídeo puede llegar a ser indisponible después de que apareció en una respuesta de canal.
Una instantánea limitada de vídeo reciente puede perder cargas antiguas o elementos entre carreras infrecuentes. No lo describa como un archivo completo o una alimentación de evento exactamente desde entonces.
Para múltiples solicitudes de flujo, elija el procesamiento de asinc o lotes dentro de los límites de su plan. Un grupo de lotes presentaciones; no hace que cada artículo libre o eliminar la necesidad de recuperar resultados de trabajo.
Ver el Referencia del canal API, Metadatos de vídeo API y guía de asinc y lotes. Para un primer flujo de trabajo de búsqueda, explorar añadir herramientas de búsqueda a un agente de inteligencia artificial.