Ga naar de inhoud
NL
API-sleutel ophalen

YouTube Data / Python

Een YouTube-kanaal ophalen met recente video's met Python

Lees een YouTube kanaal door handle, exporteer recente video IDs en metadata, en onderscheid de teruggekeerde videolijst van het totale aantal kanalen.

FlashData · Gepubliceerd

Een kanaalprofiel verbonden met een rij van recente videokaarten

Wanneer een workflow begint met een maker in plaats van een video URL, eerst het kanaal en de recente video's ophalen. Dat geeft u een begrensde lijst van video IDs voor latere metadata of bijschrift verzoeken. Deze tutorial slaat een kanaal snapshot en een eenvoudig ID bestand op met behulp van Python.

Wat het kanaaleindpunt oplevert

De youtube_channel bron accepteert een handvat zoals @jawed; de @ Voorvoegsel is optioneel. params.video_limit bestuurt hoeveel recente items te verzoeken, van 1 tot 100, met een standaard 20. Er kunnen minder video's beschikbaar zijn.

De teruggekeerden videoCount beschrijft het totale aantal video's van het kanaal. De videos array bevat de recente items die door dit verzoek worden teruggestuurd. Een verzoek voor 20-ingangen haalt niet het gehele kanaalarchief op, en dit eindpunt biedt geen gedocumenteerde paginaparameter voor het lopen van alle historische uploads.

Kanaalstatistieken en afbeeldingen kunnen ontbreken of null. Bewaar dat onderscheid in uw gegevens: een niet-beschikbaar aantal abonnees is geen kanaal met nul abonnees.

Stel het handvat in en een kleine ophaallimiet

Aanmaken API-sleutel met beschikbare Credits. Begin met een kleine limiet om de respons te inspecteren alvorens een grotere workflow te plannen. Het ophalen van kanaalgegevens en het later ophalen van elke metadata van video's zijn afzonderlijke API verzoeken.

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

Het kanaal snapshot en video IDs opslaan

Deze code opslaan als channel-videos.py. Het script controleert of het antwoord is voltooid, haalt geldige video IDs uit, en bewaart de originele videorecords in JSON. Het schrijft elke unieke ID één keer, zelfs als een bronantwoord een dubbele ingang bevat.

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

Gebruik de IDs voor een gerichte vervolgaanvraag

De kanaalrespons bevat compacte videorecords: IDs, titels, duur, aantal weergaven, uploaddata en miniaturen indien beschikbaar. Voor aanvullende details, dient u een van die IDs aan youtube_metadata. Lees de ID van het opgeslagen bestand in plaats van het te verwerken van een titel of miniatuur URL.

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

Stuur dat lichaam naar hetzelfde realtime eindpunt. De plaatshouder moet worden vervangen door een 11-karakter ID. Als u in plaats daarvan bijschriften nodig heeft, gebruik dan de bijschrift taalgids om te beslissen welke baan aanvaardbaar is voordat een verzoek wordt ingediend.

Plan voor herhaalde inzameling en grotere werklast

  • Bewaar de video IDs die u al hebt verwerkt. Vergelijk toekomstige snapshots met die set om te voorkomen dat hetzelfde downstream werk herhaaldelijk wordt ingediend.

  • Houd de collectietijd met je eigen snapshots. Tellingen kunnen veranderen en een video kan niet beschikbaar worden nadat het in een kanaalantwoord is verschenen.

  • Een beperkte recent-video snapshot kan oudere uploads of items missen tussen frequente runs. Beschrijf het niet als een compleet archief of een exact-once event feed.

  • Voor meerdere downstream verzoeken, kies async of batch verwerking binnen uw plan grenzen. Een batch groepen inzendingen; het maakt niet elk item gratis of verwijdert de noodzaak om de resultaten van de taak op te halen.

Zie de Kanaal API-referentie, Video Metadata API en async- en batchhandleiding. Voor een zoek-eerste workflow, verkennen zoekgereedschappen toevoegen aan een AI-agent.