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