Przejdź do treści
PL
Uzyskaj klucz API

YouTube Data / Python

Pobierz ostatnie filmy z kanałem YouTube z Python

Przeczytaj kanał YouTube przez uchwyt, eksportuj najnowszy film IDs i metadane, i odróżnić zwróconą listę wideo od całkowitej liczby wideo kanału.

FlashData · Opublikowane

Profil kanału podłączony do wiersza ostatnich kart wideo

Kiedy przepływ pracy zaczyna się od twórcy, a nie od wideo URL, najpierw pobrać kanał i jego ostatnie filmy. To daje ograniczoną listę wideo IDs dla późniejszych metadanych lub żądania podpisy. Ten poradnik zapisuje migawkę kanału i prosty plik ID przy użyciu standardowej biblioteki Python.

Co powróci do punktu końcowego kanału

W youtube_channel źródło akceptuje uchwyt taki jak @jawed; natomiast @ przedrostek jest opcjonalny. params.video_limit steruje iloma ostatnimi wpisami, o które należy zwrócić się, od 1 do 100, z domyślną wartością 20. Mniej filmów wideo może być dostępnych.

Zwrócony videoCount opisuje całkowitą liczbę wideo kanału. W videos tablica zawiera ostatnie wpisy zwrócone przez to żądanie. Prośba o wpisy 20 nie pobiera całego archiwum kanału, a ten punkt końcowy nie oferuje udokumentowanego parametru strony do chodzenia wszystkie historyczne pliki.

Statystyki kanału i obrazy mogą być brakujące lub null. Zachowaj to rozróżnienie w danych: niedostępna liczba abonentów nie jest kanałem z 0 abonentami.

Ustaw uchwyt i mały limit kolekcji

Utwórz Klawisz API z dostępnymi kredytami. Zacznij od małego limitu, aby sprawdzić odpowiedź przed planowaniem większego przepływu pracy. Dane kanału i późniejsze pobieranie metadanych każdego z filmów są oddzielnymi żądaniami API.

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

Zapisz migawkę kanału i wideo IDs

Zapisz ten kod jako channel-videos.py. Skrypt sprawdza, czy odpowiedź została zakończona, wyciąga ważny film IDs i zachowuje oryginalne nagrania wideo w JSON. Pisze każdy unikalny ID raz, nawet jeśli odpowiedź źródłowa zawiera duplikat wpisu.

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

Użyj IDs, aby wyświetlić wniosek o kontynuację

Odpowiedź kanału zawiera kompaktowe rekordy wideo: IDs, tytuły, czas trwania, ilość wyświetleń, daty przesyłania i miniatury, jeśli są dostępne. Aby uzyskać dodatkowe informacje, należy przedstawić jeden z tych IDs do youtube_metadata. Odczytaj ID z zapisanego pliku, zamiast próbować przetworzyć go z tytułu lub miniatury URL.

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

Wyślij to ciało do tego samego punktu końcowego w czasie rzeczywistym. Posiadacz miejsca należy zastąpić faktycznym znakiem 11- ID. Jeśli potrzebujesz podpisy zamiast, użyj napisy w języku decydowanie, który tor jest możliwy do przyjęcia przed złożeniem wniosku.

Planować powtarzające się zbieranie i większe obciążenia robocze

  • Przechowuj wideo IDs, które już przerabiałeś. Porównaj przyszłe migawki z tym zestawem, aby uniknąć wielokrotnego składania tych samych prac na dole.

  • Zachowaj czas kolekcji z własnymi zdjęciami. Liczenia mogą się zmieniać, a wideo może stać się niedostępne po pojawieniu się w odpowiedzi kanału.

  • Ograniczone migawki wideo z pamięcią mogą przegapić starsze pliki lub elementy pomiędzy rzadkimi uruchomieniami. Nie należy go opisywać jako kompletnego archiwum lub dokładnego - jednorazowego kanału zdarzeń.

  • W przypadku wielu wniosków dotyczących dalszych etapów procesu przetwarzania należy wybrać async lub partię w granicach planu. Zgłoszenia grup wsadowych; nie powoduje to, że każda pozycja jest wolna ani nie usuwa potrzeby uzyskania wyników pracy.

Patrz Odniesienie do kanału API, Metadane wideo API oraz async i przewodnik po serii. Dla przeszukania - pierwszy przepływ pracy, odkryj dodawanie narzędzi wyszukiwania do agenta AI.