Überspringen zum Inhalt
DE
API-Schlüssel

YouTube Data / Python

Holen Sie sich die letzten Videos eines YouTube-Kanals mit Python

Lesen Sie einen YouTube-Kanal nach Handle, exportieren Sie das aktuelle Video IDs und Metadaten und unterscheiden Sie die zurückgegebene Videoliste von der gesamten Videoanzahl des Kanals.

FlashData · Veröffentlicht

Ein Kanalprofil, das mit einer Reihe von aktuellen Grafikkarten verbunden ist

Wenn ein Workflow mit einem Ersteller und nicht mit einem Video URL beginnt, rufen Sie zuerst den Kanal und seine letzten Videos ab. Das gibt Ihnen eine begrenzte Liste von Video IDs für spätere Metadaten oder Bildunterschriften. Dieses Tutorial speichert einen Kanal-Snapshot und eine einfache ID-Datei mit der Standardbibliothek von Python.

Was der Channel-Endpunkt zurückgibt

Die youtube_channel Die Quelle akzeptiert einen Handle wie @jawed; der @ Präfix ist optional. params.video_limit steuert, wie viele aktuelle Einträge von 1 zu 100 mit einem Standard von 20 angefordert werden sollen. Möglicherweise sind weniger Videos verfügbar.

Die Rückkehr videoCount beschreibt die gesamte Videoanzahl des Kanals. Die videos Ein Array enthält die letzten Einträge, die durch diese Anforderung zurückgegeben wurden. Eine Anforderung für 20-Einträge ruft nicht das gesamte Kanalarchiv ab, und dieser Endpunkt bietet keinen dokumentierten Seitenparameter zum Durchlaufen aller historischen Uploads.

Kanalstatistiken und Bilder können fehlen oder null. Behalten Sie diesen Unterschied in Ihren Daten: Eine nicht verfügbare Abonnentenzahl ist kein Kanal mit null Abonnenten.

Setzen Sie den Griff und ein kleines Sammellimit

Erstellen Sie eine API Schlüssel mit verfügbaren Credits. Beginnen Sie mit einem kleinen Limit, um die Antwort zu überprüfen, bevor Sie einen größeren Workflow planen. Das Abrufen von Kanaldaten und das spätere Abrufen der Metadaten jedes Videos sind separate API-Anforderungen.

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

Speichern Sie den Kanal Snapshot und Video IDs

Speichern Sie diesen Code als channel-videos.py. Das Skript überprüft, ob die Antwort abgeschlossen ist, extrahiert gültiges Video IDs und bewahrt die ursprünglichen Videoaufzeichnungen in JSON. Es schreibt jedes eindeutige ID einmal, auch wenn eine Quellantwort einen doppelten Eintrag enthält.

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

Verwenden Sie den IDs für eine fokussierte Folgeanforderung

Die Kanalantwort enthält kompakte Videoaufzeichnungen: IDs, Titel, Dauer, Anzahl der Ansichten, Upload-Daten und Miniaturansichten, wenn verfügbar. Für weitere Details senden Sie eine dieser IDs an youtube_metadata. Lesen Sie das ID aus der gespeicherten Datei, anstatt zu versuchen, es aus einem Titel oder einer Miniaturansicht URL zu analysieren.

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

Senden Sie diesen Körper an den gleichen Echtzeit-Endpunkt. Der Platzhalter muss durch ein aktuelles 11-Zeichen ID ersetzt werden. Wenn Sie stattdessen Untertitel benötigen, verwenden Sie die Beschriftung Sprachführer zu entscheiden, welche Spur akzeptabel ist, bevor ein Antrag gestellt wird.

Planen Sie wiederholtes Sammeln und größere Workloads

  • Speichern Sie das Video IDs, das Sie bereits verarbeitet haben. Vergleichen Sie zukünftige Snapshots mit dem Set, um zu vermeiden, dass dieselben nachgelagerten Arbeiten wiederholt eingereicht werden.

  • Halten Sie die Sammlungszeit mit Ihren eigenen Snapshots. Zählungen können sich ändern und ein video kann nicht verfügbar sein, nachdem es in einer kanalantwort erschienen ist.

  • Eine begrenzte aktuelle Video-Snapshot kann ältere Uploads oder Elemente zwischen seltenen Läufen verpassen. Beschreiben Sie es nicht als ein vollständiges Archiv oder einen exakt einmaligen Ereignis-Feed.

  • Für mehrere nachgelagerte Anfragen wählen Sie Async oder Batch-Verarbeitung innerhalb der Grenzen Ihres Plans. Eine Batch-Gruppeneinreichungen; es macht nicht jeden Artikel frei oder beseitigt die Notwendigkeit, Arbeitsergebnisse abzurufen.

Siehe Kanal API, Video Metadaten API und async und Batch Guide. Für einen Search-First Workflow, erkunden Hinzufügen von Suchwerkzeugen zu einem AI-Agenten.