YouTube मेटाडेटा API

एक YouTube मेटाडेटा API वीडियो के बारे में संरचित जानकारी लौटाता है — उसका टाइटल, ड्यूरेशन, थंबनेल और उपलब्ध फ़ॉर्मेट — बिना कुछ डाउनलोड किए। यह गाइड दिखाती है कि Tunelio GET /info एंडपॉइंट से यह डेटा एक request में कैसे पढ़ें।

मेटाडेटा एंडपॉइंट क्या लौटाता है

GET /info एक ही url पैरामीटर लेता है और वीडियो का title, duration (सेकंड में और एक पढ़ने-लायक string, दोनों), सबसे ऊँचे रिज़ॉल्यूशन का thumbnail, और एक formats array लौटाता है जो हर डाउनलोड-योग्य वीडियो व ऑडियो रेंडिशन को उसके सटीक file size के साथ बताता है।

curl "https://tunelio.dev/info?url=https://youtu.be/dQw4w9WgXcQ" \
  -H "Authorization: Bearer tnl_your_api_key"

{
  "title": "Example Video",
  "duration_seconds": 213,
  "duration_str": "03:33",
  "thumbnail": "https://i.ytimg.com/vi_webp/…/maxresdefault.webp",
  "formats": [
    { "quality": "1080p", "file_size_str": "48.10 MB", "width": 1920, "height": 1080 },
    { "quality": "720p",  "file_size_str": "28.52 MB", "width": 1280, "height": 720 }
  ],
  "audioFormat": { "format": "mp3", "file_size_str": "3.29 MB" }
}

आम इस्तेमाल

• उपयोगकर्ता के डाउनलोड करने से पहले वीडियो का प्रीव्यू दिखाएँ — title, thumbnail और duration।
• हर रिज़ॉल्यूशन और उसका सटीक size दिखाकर उपयोगकर्ताओं को फ़ॉर्मेट चुनने दें।
• डाउनलोड पर क्रेडिट खर्च करने से पहले URL जाँचें और पुष्टि करें कि वीडियो मौजूद है।

इसे Python में पढ़ें

import os, requests

info = requests.get(
    "https://tunelio.dev/info",
    params={"url": "https://youtu.be/dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {os.environ['TUNELIO_KEY']}"},
).json()

print(info["title"], info["duration_str"])
for f in info["formats"]:
    print(f["quality"], f["file_size_str"])

डाउनलोड से पहले वीडियो जाँचें

GET /info यह पुष्टि करने का सबसे सस्ता तरीका भी है कि /create पर क्रेडिट खर्च करने से पहले कोई वीडियो मौजूद और डाउनलोड-योग्य है। अगर URL प्राइवेट, डिलीट किया हुआ, या geo-blocked है, तो /info एक error लौटाता है जिसे आप उपयोगकर्ता को तुरंत दिखा सकते हैं — कोई बेकार डाउनलोड कोशिश नहीं। यहाँ duration_seconds फ़ील्ड भी काम आती है, ताकि livestream या आपके ऐप की अनुमत सीमा से लंबे वीडियो रिजेक्ट किए जा सकें।

थंबनेल और ड्यूरेशन

thumbnail फ़ील्ड वह सबसे ऊँचे रिज़ॉल्यूशन की इमेज है जिसे YouTube उस वीडियो के लिए देता है, इसलिए आप बिना दूसरी request के प्रीव्यू कार्ड दिखा सकते हैं। duration_str पहले से HH:MM:SS (या एक घंटे से कम पर MM:SS) फ़ॉर्मेट में होता है, जबकि duration_seconds आपको अपनी फ़ॉर्मेटिंग या फ़िल्टरिंग के लिए कच्चा integer देता है।

लागत

हर GET /info कॉल की लागत 6 क्रेडिट है, और नए अकाउंट को शुरुआत में 100 फ्री क्रेडिट मिलते हैं। चूँकि /info सटीक file size बताता है, आप उपयोगकर्ताओं को फ़ॉर्मेट चुनने दे सकते हैं, इससे पहले कि आप GET /create डाउनलोड पर लगने वाले 10 क्रेडिट खर्च करें।

अगले कदम

पूरे /info response schema और हर फ़ील्ड के लिए संपूर्ण API डॉक्युमेंटेशन देखें, या इसे GET /create के साथ जोड़कर पढ़े गए मेटाडेटा को सीधे डाउनलोड URL में बदलें।