Quando un flusso di lavoro inizia con un creatore piuttosto che un video URL, prima recuperare il canale e i suoi video recenti. Questo ti dà un elenco limitato di video IDs per le richieste di metadati o didascalie successive. Questo tutorial salva un'istantanea del canale e un semplice file ID utilizzando la libreria standard di Python.
Che cosa restituisce il endpoint del canale
Il youtube_channel fonte accetta una maniglia come @jawed; il @ il prefisso è facoltativo. params.video_limit controlla quante voci recenti da richiedere, da 1 a 100, con un default di 20. Pochi video possono essere disponibili.
Il ritorno videoCount descrive il numero totale di video del canale. Il videos array contiene le ultime voci restituite da questa richiesta. Una richiesta per le voci 20 non recupera l'intero archivio del canale, e questo endpoint non offre un parametro di pagina documentato per la gestione di tutti i caricamenti storici.
Le statistiche e le immagini del canale possono essere mancanti o null. Mantenere tale distinzione nei vostri dati: un conteggio abbonato non disponibile non è un canale con abbonati zero.
Impostare la maniglia e un piccolo limite di raccolta
Creare un Chiave API con Crediti disponibili. Inizia con un piccolo limite per ispezionare la risposta prima di pianificare un flusso di lavoro più ampio. I dati relativi al canale di registrazione e successivamente l'acquisizione dei metadati di ogni video sono richieste API separate.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
Salvare l'istantanea del canale e il video IDs
Salvare questo codice come channel-videos.py. Lo script controlla che la risposta sia stata completata, estrae il video valido IDs e conserva i record video originali in JSON. Scrive ogni singolare ID una volta, anche se una risposta sorgente contiene una voce duplicata.
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
Utilizzare IDs per una richiesta di follow-up focalizzata
La risposta del canale contiene record video compatti: IDs, titoli, durata, conteggi di vista, date di caricamento e miniature quando disponibili. Per ulteriori dettagli, inviare uno di questi IDs a youtube_metadata. Leggere lo ID dal file salvato piuttosto che cercare di analizzarlo da un titolo o thumbnail URL.
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}
Mandate quel corpo allo stesso punto finale in tempo reale. Il segnaposto deve essere sostituito con un vero e proprio 11-character ID. Se hai bisogno di didascalie, usa il guida della lingua di captazione decidere quale traccia è accettabile prima di presentare una richiesta.
Pianifica la raccolta ripetuta e i carichi di lavoro più grandi
Memorizza il video IDs che hai già elaborato. Confrontare le istantanee future con quella serie per evitare di inviare ripetutamente lo stesso lavoro a valle.
Tenere il tempo di raccolta con le proprie istantanee. I conti possono cambiare e un video può diventare non disponibile dopo che è apparso in una risposta del canale.
Un'istantanea limitata di recente video può mancare caricamenti o elementi più vecchi tra le rune infrequenti. Non descriverlo come un archivio completo o un feed eventi esattamente-unnce.
Per più richieste a valle, scegli l'elaborazione asincrona o batch entro i limiti del tuo piano. Un gruppo di gruppo di messaggi; non rende ogni elemento libero o rimuovere la necessità di recuperare i risultati del lavoro.
Vedi il Riferimento canale API, Video Metadati API e guida asincrona e batch. Per un primo flusso di lavoro di ricerca, esplorare aggiungere strumenti di ricerca a un agente AI.