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