सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें

YouTube Data / Python

Python के साथ एक YouTube चैनल के हाल के वीडियो प्राप्त करें

हैंडल द्वारा एक YouTube चैनल को पढ़ें, हाल के वीडियो IDs और मेटाडाटा का निर्यात करें, और चैनल की कुल वीडियो गिनती से वापसी की गई वीडियो सूची को अलग करें।

FlashData · प्रकाशित

हाल के वीडियो कार्डों की एक पंक्ति से जुड़े एक चैनल प्रोफाइल

जब एक वर्कफ़्लो एक वीडियो URL के बजाय एक निर्माता के साथ शुरू होता है, तो पहले चैनल और उसके हाल के वीडियो को पुनः प्राप्त करें। यह आपको बाद में मेटाडाटा या कैप्शन अनुरोधों के लिए वीडियो IDs की एक सीमित सूची देता है। यह ट्यूटोरियल एक चैनल स्नैपशॉट और एक सरल ID फ़ाइल को Python के मानक पुस्तकालय का उपयोग करके बचाता है।

चैनल एंडपॉइंट रिटर्न क्या देता है

यह youtube_channel स्रोत इस तरह के रूप में एक संभाल स्वीकार करते हैं @jawed; यह @ उपसर्ग वैकल्पिक है। params.video_limit कितनी हाल की प्रविष्टियों को अनुरोध करने के लिए नियंत्रित करता है, 1 से 100 तक, 20 के डिफ़ॉल्ट के साथ। कम वीडियो उपलब्ध हो सकते हैं।

वापस आ गया videoCount चैनल के वीडियो की कुल संख्या बताता है। यह videos सरणी में हाल की प्रविष्टियां इस अनुरोध से वापस आती हैं। 20 प्रविष्टियों के लिए एक अनुरोध पूरे चैनल संग्रह को पुनर्प्राप्त नहीं करता है, और यह समापन बिंदु सभी ऐतिहासिक अपलोडों को चलने के लिए एक दस्तावेज पेज पैरामीटर प्रदान नहीं करता है।

चैनल सांख्यिकी और छवियों को याद किया जा सकता है या null. अपने डेटा में उस अंतर को रखें: एक अनुपलब्ध ग्राहक गिनती शून्य ग्राहक के साथ एक चैनल नहीं है।

हैंडल और एक छोटी संग्रह सीमा निर्धारित करें

बनाना API कुंजी उपलब्ध क्रेडिट के साथ। एक बड़े वर्कफ़्लो की योजना बनाने से पहले प्रतिक्रिया का निरीक्षण करने के लिए एक छोटी सीमा के साथ शुरू करें। Fetching चैनल डेटा और बाद में प्रत्येक वीडियो का मेटाडाटा अलग API अनुरोध हैं।

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

चैनल स्नैपशॉट और वीडियो IDs सहेजें

इस कोड को सहेजें channel-videos.py. स्क्रिप्ट यह जांचती है कि प्रतिक्रिया पूरी हो गई है, वैध वीडियो IDs को निकालती है और JSON में मूल वीडियो रिकॉर्ड को संरक्षित करती है। यह एक बार प्रत्येक अद्वितीय ID लिखता है, भले ही स्रोत प्रतिक्रिया में एक डुप्लिकेट प्रविष्टि हो।

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

एक केंद्रित अनुवर्ती अनुरोध के लिए IDs का उपयोग करें

चैनल प्रतिक्रिया में कॉम्पैक्ट वीडियो रिकॉर्ड शामिल हैं: IDs, शीर्षक, अवधि, दृश्य गणना, अपलोड तिथियां और अंगूठे उपलब्ध होने पर। अतिरिक्त विवरण के लिए, उनमें से एक को जमा करें IDs youtube_metadata. सहेजी गई फ़ाइल से ID को एक शीर्षक या थंबनेल URL से पार्स करने की कोशिश करने के बजाय पढ़ें।

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

उस शरीर को उसी वास्तविक समय के समापन बिंदु पर भेजें। प्लेसहोल्डर को वास्तविक 11-character ID के साथ प्रतिस्थापित किया जाना चाहिए। यदि आपको इसके बजाय कैप्शन की आवश्यकता है, तो उपयोग करें कैप्शन भाषा गाइड यह तय करने के लिए कि कौन सा ट्रैक अनुरोध प्रस्तुत करने से पहले स्वीकार्य है।

योजना बार-बार संग्रह और बड़े कार्यभार

  • वीडियो स्टोर करें IDs आपने पहले ही संसाधित किया है। उस सेट के साथ भविष्य के स्नैपशॉट की तुलना में उसी डाउनस्ट्रीम वर्क को बार-बार जमा करने से बचने के लिए।

  • अपने स्वयं के स्नैपशॉट्स के साथ संग्रह समय रखें। एक चैनल प्रतिक्रिया में दिखाई देने के बाद गिनती बदल सकती है और एक वीडियो अनुपलब्ध हो सकता है।

  • एक सीमित हाल के वीडियो स्नैपशॉट पुराने अपलोड या गलत रनों के बीच आइटम याद कर सकते हैं। इसे एक पूर्ण संग्रह या बिल्कुल-once घटना फ़ीड के रूप में वर्णित नहीं करते हैं।

  • एकाधिक डाउनस्ट्रीम अनुरोधों के लिए, अपनी योजना की सीमाओं के भीतर एसिंक या बैच प्रोसेसिंग चुनें। एक बैच समूह प्रस्तुतियाँ; यह प्रत्येक आइटम को मुक्त नहीं बनाता है या नौकरी के परिणाम को पुनः प्राप्त करने की आवश्यकता को हटा देता है।

देखें चैनल API संदर्भ, वीडियो मेटाडाटा API और async और बैच गाइड. एक खोज-पहली वर्कफ़्लो के लिए, अन्वेषण करें एक एआई एजेंट को खोज उपकरण जोड़ना.