Lewati ke isi
ID
Dapatkan kunci API

YouTube Data / Python

Ambil video baru-baru ini YouTube dengan Python

Baca kanal YouTube dengan cara menangani, ekspor video terbaru IDs dan metadata, dan bedakan daftar video yang dikembalikan dari total jumlah video saluran.

FlashData · Diterbitkan

Profil saluran terhubung ke baris dari kartu video baru-baru ini

Ketika sebuah alur kerja dimulai dengan seorang pencipta, bukan video URL, pertama mengambil kanal dan video terbaru. Yang memberikan Anda daftar bounded dari video IDs untuk permintaan metadata atau judul nanti. Tutorial ini menyimpan snapshot saluran dan berkas ID sederhana menggunakan pustaka standar Python.

Apa hasil titik akhir saluran

The youtube_channel sumber menerima handle seperti @jawed; bagian @ prefix adalah opsional. params.video_limit kontrol berapa banyak masukan terbaru untuk permintaan, dari 1 ke 100, dengan baku dari 20. Sedikit video mungkin tersedia.

Yang kembali videoCount Menjelaskan jumlah total video saluran. The videos array berisi masukan baru-baru ini dikembalikan oleh permintaan ini. Permintaan untuk entri 20 tidak mengambil seluruh arsip saluran, dan titik akhir ini tidak menawarkan parameter halaman terdokumentasi untuk berjalan semua uploads historis.

Statistik saluran dan gambar dapat hilang atau null. Simpan perbedaan dalam data Anda: jumlah pelanggan yang tidak tersedia bukan saluran dengan pelanggan nol.

Atur handle dan batas koleksi kecil

Buat kunci API dengan Credits yang tersedia. Mulailah dengan batas kecil untuk memeriksa respon sebelum merencanakan aliran kerja yang lebih besar. Mengambil data saluran dan kemudian mengambil setiap metadata video terpisah dengan permintaan API.

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

Simpan snapshot saluran dan video IDs

Simpan kode ini sebagai channel-videos.py. Cek script yang telah selesai, mengekstrak video yang valid IDs, dan mempertahankan catatan video asli dalam JSON. Ini menulis setiap unik ID sekali, bahkan jika sumber respon berisi entri duplikat.

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

Gunakan IDs untuk fokus mengikuti permintaan

Respon saluran berisi rekaman video kompak: IDs, judul, durasi, jumlah tilikan, unggah tanggal dan thumbnails ketika tersedia. Untuk rincian tambahan, kirim salah satu IDs ke youtube_metadata. Baca ID dari berkas yang disimpan daripada mencoba menguraikannya dari judul atau thumbnail URL.

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

Kirim tubuh itu ke titik akhir yang sama. Placeholder harus diganti dengan aktual 11-character ID. Jika Anda perlu terjemahan, gunakan Panduan bahasa kapsi untuk memutuskan trek mana yang dapat diterima sebelum mengirimkan permintaan.

Rencana berulang koleksi dan beban kerja yang lebih besar

  • Simpan video IDs yang telah Anda proses. Bandingkan gambar masa depan dengan set itu untuk menghindari pengajuan pekerjaan hilir yang sama berulang-ulang.

  • Jauhkan waktu koleksi dengan snapshot Anda sendiri. Menghitung dapat berubah dan video dapat menjadi tidak tersedia setelah muncul dalam respon saluran.

  • Sebuah rekaman video yang terbatas dapat melewatkan uploads atau item yang lebih tua antara berjalan tidak sering. Jangan menggambarkannya sebagai arsip lengkap atau secara tepat-sekali event feed.

  • Untuk beberapa permintaan hilir, pilih Aznc atau proses batch dalam batas rencana Anda. Sebuah pengiriman batch group; ini tidak membuat setiap item bebas atau menghapus kebutuhan untuk mengambil hasil kerja.

Lihat Referensi API saluran, Video Metadata API dan async dan batch guide. Untuk pencarian aliran kerja pertama, eksplorasi menambahkan alat pencarian ke agen AI.