YouTube Downloader API

एक YouTube downloader API आपके ऐप, बॉट या बैकएंड को एक YouTube लिंक से इस्तेमाल-के-लिए-तैयार डाउनलोड URL बनाने देता है — न ब्राउज़र ऑटोमेशन और न लोकल कन्वर्ज़न। यह गाइड दिखाती है कि Tunelio API से इसे एक ही request में कैसे करें।

YouTube downloader API क्या करता है

पेजों को scrape करने या भारी लोकल एक्सट्रैक्टर चलाने के बजाय, आप एक YouTube URL को एंडपॉइंट पर भेजते हैं और फ़ाइल के लिए सीधा, signed डाउनलोड URL पाते हैं। आपके सर्वर हल्के रहते हैं, और जवाब एक ही राउंड-ट्रिप में आ जाता है — न कोई job ID ट्रैक करना है और न कोई status एंडपॉइंट poll करना है।

Tunelio ठीक दो एंडपॉइंट देता है। GET /info किसी वीडियो को जाँचता है और हर उपलब्ध फ़ॉर्मेट को उसके सटीक फ़ाइल आकार के साथ सूचीबद्ध करता है; GET /create आपके चुने हुए quality के लिए सीधा डाउनलोड URL लौटाता है। इससे इंटीग्रेशन इतना छोटा रहता है कि उसे एक बैठक में पढ़ लिया जाए।

ऑथेंटिकेशन

हर request आपके API key को Bearer token के रूप में साथ ले जाता है। नए अकाउंट को 100 फ्री क्रेडिट मिलते हैं, और आप Telegram या Email से करीब एक मिनट में साइन अप कर सकते हैं — किसी क्रेडिट कार्ड की ज़रूरत नहीं।

Authorization: Bearer tnl_your_api_key

क्विक स्टार्ट

पहले वीडियो को जाँचें ताकि पता चले कौन-से फ़ॉर्मेट उपलब्ध हैं, फिर अपने मनचाहे quality के लिए सीधा URL माँगें। cURL के साथ पूरा फ़्लो यहाँ है:

# 1. List available formats (6 credits)
curl "https://tunelio.dev/info?url=https://youtu.be/dQw4w9WgXcQ" \
  -H "Authorization: Bearer tnl_your_api_key"

# 2. Get a direct download URL for 1080p (10 credits)
curl "https://tunelio.dev/create?url=https://youtu.be/dQw4w9WgXcQ&quality=1080p" \
  -H "Authorization: Bearer tnl_your_api_key"

/create का जवाब एक url फ़ील्ड शामिल करता है — एक signed डाउनलोड लिंक जिसे आप सीधे अपने उपयोगकर्ता को दे सकते हैं या स्टोरेज में स्ट्रीम कर सकते हैं। यह कई घंटों तक मान्य रहता है।

Python

import os, requests

H = {"Authorization": f"Bearer {os.environ['TUNELIO_KEY']}"}

info = requests.get(
    "https://tunelio.dev/info",
    params={"url": "https://youtu.be/dQw4w9WgXcQ"},
    headers=H,
).json()
print(info["formats"][0]["quality"])  # e.g. "1080p"

dl = requests.get(
    "https://tunelio.dev/create",
    params={"url": "https://youtu.be/dQw4w9WgXcQ", "quality": "1080p"},
    headers=H,
).json()
print(dl["url"])  # direct download URL

quality और फ़ॉर्मेट चुनना

quality पैरामीटर एक वीडियो लेबल लेता है जैसे 144p, 240p, 360p, 480p, 720p या 1080p — और Mega प्लान पर 2160p (4K)। सिर्फ़ ऑडियो वाली MP3 फ़ाइल पाने के लिए इसके बजाय quality=mp3 पास करें। चूँकि GET /info हर फ़ॉर्मेट का सटीक बाइट आकार पहले ही बता देता है, आप उपयोगकर्ताओं को डाउनलोड तय करने से पहले आकार दिखा सकते हैं।

कीमत और क्रेडिट

/info की हर कॉल 6 क्रेडिट लेती है और हर /create 10; लौटाए गए URL से असली फ़ाइल डाउनलोड मुफ़्त है। प्लान 100-क्रेडिट के फ्री ट्रायल से शुरू होकर Pro ($9/mo, 100,000 क्रेडिट), Ultra ($39/mo, 500,000 क्रेडिट) और Mega ($89/mo, 4K MP4 के साथ 1.5M क्रेडिट) तक हैं।

अगले कदम

यही पूरा API है। रिस्पॉन्स फ़ील्ड, एरर कोड और रेट लिमिट के लिए पूरा रेफरेंस पढ़ें, फिर अपने फ्री क्रेडिट लें और अपनी पहली कॉल करें।