Salta al contenuto
IT
Ottieni la chiave API

YouTube Data / Python

Ottenere i video recenti di un canale YouTube con Python

Leggere un canale YouTube tramite maniglia, esportare il video recente IDs e metadati, e distinguere l'elenco video restituito dal conteggio video totale del canale.

FlashData · Pubblicato

Un profilo di canale collegato a una fila di schede video recenti

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.

bash
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.

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

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.

json
{"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.