YouTube डाउनलोड और जानकारी API के साथ काम करना

आपको उपयोगकर्ताओं को एक YouTube वीडियो डाउनलोड करने या एक विशिष्ट प्रारूप में ऑडियो निकालने की अनुमति देने की आवश्यकता है और आपको यह इस सप्ताह काम करने की आवश्यकता है। इस गाइड के अंत तक, आपके पास एक कॉपी-पेस्ट करने योग्य अनुरोध होगा जो एक विशिष्ट YouTube URL के लिए एक तैयार-से-उपयोग डाउनलोड कार्य लौटाता है, साथ ही इसे आपके मीडिया कार्यप्रवाह में जोड़ने के लिए व्यावहारिक नोट्स भी होंगे।

यह API क्या करती है और इसका उपयोग कब करें

Zyla API Hub पर YouTube डाउनलोड और जानकारी API आपको एक साधारण HTTP एंडपॉइंट देती है जिससे आप एक YouTube वीडियो या ऑडियो का डाउनलोड करने योग्य संस्करण अनुरोध कर सकते हैं। आप YouTube URL और वह प्रारूप पास करते हैं जो आप चाहते हैं; API एक कार्य पहचानकर्ता, एक थंबनेल छवि URL, और एक प्रगति URL लौटाती है जिसका उपयोग आप कार्य की निगरानी के लिए कर सकते हैं।

विशिष्ट उपयोग के मामले:

• उपयोगकर्ताओं को ऑफ़लाइन उपयोग के लिए 720p या 1080p में एक वीडियो डाउनलोड करने दें।
• पॉडकास्ट बैकफिल्स या वॉयसओवर सैंपलिंग के लिए ऑडियो ट्रैक निकालें (जैसे, mp3, m4a, flac, opus, wav)।
• बैच उपकरण जो निर्माताओं के अपलोड को एक निश्चित सेट के डिलीवरबल्स में मानकीकृत करते हैं।

Zyla API Hub एक खाते, एक API कुंजी, और एक सदस्यता + कोटा मॉडल के तहत मीडिया और अन्य श्रेणियों में 10,000 से अधिक सार्वजनिक APIs की मेज़बानी करता है। यह API मीडिया श्रेणी का हिस्सा है और वीडियो/ऑडियो पुनर्प्राप्ति पर केंद्रित है।

Zyla API Hub पर शुरू करना

इस API को कॉल करने के लिए, मार्केटप्लेस लिस्टिंग खोलें और सदस्यता लें। आपको Zyla APIs के लिए उपयोग की जाने वाली एक API कुंजी मिलेगी, और आप एक प्राधिकरण हेडर के साथ प्रमाणीकरण करते हैं। आप जो पहला API चुनते हैं उसे आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ आजमाया जा सकता है—जो वर्तमान में उपलब्ध है, उसके लिए लिस्टिंग की जांच करें।

• लिस्टिंग पर जाएं: YouTube डाउनलोड और जानकारी API पर 7-दिन की परीक्षण अवधि शुरू करें
• सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें) और अपनी API कुंजी कॉपी करें।
• अपने अनुरोधों में हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

आप Zyla API Hub पर उसी खाते और कुंजी के साथ अन्य मीडिया APIs और श्रेणियों का अन्वेषण कर सकते हैं।

एंडपॉइंट: डाउनलोड

यह एंडपॉइंट दिए गए YouTube URL का एक डाउनलोड करने योग्य संस्करण अनुरोध करता है एक निर्दिष्ट प्रारूप में, और प्रगति को ट्रैक करने के लिए एक कार्य विवरण लौटाता है।

• विधि: GET
• URL: https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
• आवश्यक क्वेरी पैरामीटर:
  • url (string): YouTube URL। उदाहरण: https://www.youtube.com/watch?v=aGSKrC7dGcY (अनुरोध में URL-कोड करें)।
  • format (string): इच्छित आउटपुट प्रारूप।

समर्थित प्रारूप:

• वीडियो: 360p, 480p, 720p, 1080p, 1440p, 2160p
• ऑडियो: mp3, m4a, flac, opus, wav

नोट्स:

• ऑडियो डाउनलोड लिंक 2 घंटे बाद समाप्त हो जाते हैं।
• यह एंडपॉइंट केवल नियमित वीडियो डाउनलोड का समर्थन करता है।

आधिकारिक cURL उदाहरण

curl -s -X GET "https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DaGSKrC7dGcY&format=720" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक उदाहरण प्रतिक्रिया

{
"success": true,
"id": "2ec15939807689549d3f3115f168be6b9c868105",
"image": "https://i.ytimg.com/vi/aGSKrC7dGcY/hqdefault.jpg",
"progress_url": "https://youtube-api-progress-copy-development.up.railway.app/api/progress?id=2ec15939807689549d3f3115f168be6b9c868105"
}

आप वास्तव में जिन फ़ील्ड के अर्थों का उपयोग करेंगे:

• success: क्या कार्य सफलतापूर्वक कतारबद्ध किया गया था।
• id: कार्य पहचानकर्ता; इसे लॉग और UI स्थिति को सहसंबंधित करने के लिए स्टोर करें।
• image: एक थंबनेल जिसे आप कार्य चलने के दौरान अपने UI में दिखा सकते हैं।
• progress_url: एक URL जिसे आप कार्य की प्रगति की जांच करने के लिए क्वेरी कर सकते हैं। इसका उपयोग अपने फ्रंटेंड या कार्यकर्ता में पोलिंग को चलाने के लिए करें। यदि आप ऑडियो डाउनलोड को उजागर करते हैं, तो याद रखें कि ऑडियो लिंक 2 घंटे बाद समाप्त हो जाते हैं।

Python उदाहरण जो requests का उपयोग करता है

यह नमूना उसी एंडपॉइंट को उसी पैरामीटर के साथ कॉल करता है जैसे आधिकारिक cURL, JSON को पार्स करता है, और कार्य मेटाडेटा को प्रिंट करता है। जब आप उस वीडियो ID का परीक्षण करते हैं तो प्राधिकरण हेडर और URL को ठीक उसी तरह रखें जैसे दिखाया गया है; आवश्यकतानुसार समर्थित मानों में से एक में प्रारूप को स्वैप करें।

import requests
from urllib.parse import quote_plus

API_KEY = "YOUR_API_KEY"
youtube_url = "https://www.youtube.com/watch?v=aGSKrC7dGcY"
format_value = "720" # या "1080p", "mp3", "m4a", "flac", "opus", "wav", आदि।

encoded_url = quote_plus(youtube_url)
endpoint = (
"https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download"
f"?url={encoded_url}&format={format_value}"
)

headers = {
"Authorization": f"Bearer {API_KEY}",
}

resp = requests.get(endpoint, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()

# API द्वारा लौटाए गए फ़ील्ड का उपयोग करें
print("Success:", data.get("success"))
print("Job ID:", data.get("id"))
print("Thumbnail:", data.get("image"))
print("Progress URL:", data.get("progress_url"))

# उदाहरण: यदि आप progress_url की पोलिंग करना चाहते हैं, तो एक छोटा बैकऑफ रखें और तब तक रुकें
# जब आपका UI या कार्यकर्ता देखता है कि कार्य पूरा हो गया है। प्रगति के प्रारूप
# प्रतिक्रियाएँ यहाँ प्रलेखित नहीं हैं; अपनी पोलिंग को विवेकपूर्ण रूप से डिज़ाइन करें।

समय बचाने के लिए कार्यान्वयन विवरण

• URL एन्कोडिंग: हमेशा url पैरामीटर के लिए YouTube लिंक को URL-एन्कोड करें। कई विफलताएँ कच्चे ampersands के कारण होती हैं जो देखी गई URLs में होती हैं।
• फॉर्मेट स्ट्रिंग: वीडियो के लिए, सूचीबद्ध रिज़ॉल्यूशंस का उपयोग करें (जैसे, 720p या 1080p)। ऑडियो के लिए, mp3, m4a, flac, opus, wav में से एक का उपयोग करें। यदि आपके UI में एक ड्रॉपडाउन है, तो कॉल करने से पहले उस सूची के खिलाफ मान्य करें।
• कार्य ट्रैकिंग: अपने डेटाबेस में लौटाए गए id को बनाए रखें और इसे वर्तमान उपयोगकर्ता/सत्र के साथ जोड़ें ताकि आप पृष्ठ ताज़ा करने के बाद प्रगति संकेतक को पुनर्स्थापित कर सकें।
• थंबनेल: डाउनलोड कार्य चलने के दौरान अपने UI में तात्कालिक प्रतिक्रिया प्रदान करने के लिए छवि फ़ील्ड का उपयोग करें।
• ऑडियो समाप्ति: ऑडियो डाउनलोड लिंक 2 घंटे बाद समाप्त हो जाते हैं। यदि आपका कार्यप्रवाह विलंबित पुनर्प्राप्ति (जैसे, बाद में ईमेल) शामिल करता है, तो या तो मांग पर पुन: उत्पन्न करने को प्रेरित करें या उपयोगकर्ताओं को तुरंत डाउनलोड करने के लिए निर्देशित करें।
• पुनः प्रयास: यदि आप progress_url पर पोलिंग लागू करते हैं, तो अपने बैकऑफ को विनम्र रखें ताकि आप अधिक न करें। UI झिलमिलाहट से बचने के लिए अपने स्टोर में नवीनतम स्थिति को कैश करें।
• लाइव स्ट्रीम: यह एंडपॉइंट नियमित वीडियो का समर्थन करता है। यदि उपयोगकर्ता लाइव स्ट्रीम चिपकाते हैं, तो API को कॉल करने से पहले एक मान्यता त्रुटि दिखाएं।
• सदस्यता + कोटा: कॉल आपके योजना के कोटा का उपभोग करते हैं; यह API प्रति कॉल भुगतान नहीं है। वर्तमान पहुंच विकल्पों के लिए लिस्टिंग की जांच करें। आप जो पहला API चुनते हैं वह आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है।

सामान्य वास्तविक-विश्व प्रवाह

1) “डाउनलोड के रूप में” मोडाल एक वेब ऐप में

1. उपयोगकर्ता एक YouTube URL चिपकाता है और एक प्रारूप चुनता है (जैसे, 1080p वीडियो या mp3 ऑडियो)।
2. आपका फ्रंटेंड आपके बैकेंड को कॉल करता है, जो url और प्रारूप के साथ डाउनलोड एंडपॉइंट को सक्रिय करता है।
3. छवि से थंबनेल प्रदर्शित करें और जब आप सर्वर पर progress_url की पोलिंग करते हैं तो एक स्पिनर दिखाएं।
4. जब पूरा हो जाए, तो उपयोगकर्ता को अंतिम डाउनलोड लिंक प्रस्तुत करें। ऑडियो के लिए, 2 घंटे की समाप्ति के बारे में एक नोट दिखाएं।

2) बैच मीडिया लाइब्रेरी सामान्यीकरण

1. YouTube URLs और लक्षित प्रारूपों (जैसे, सभी 720p वीडियो पूर्वावलोकन के लिए) की एक कतार बनाए रखें।
2. प्रत्येक कार्य के लिए डाउनलोड एंडपॉइंट को कॉल करें; id और progress_url स्टोर करें।
3. एक कार्यकर्ता को progress_url की पोलिंग करने दें ताकि कार्य की स्थितियों को आगे बढ़ाया जा सके और जैसे ही वे उपलब्ध हों, परिणामों को क्लाउड स्टोरेज में पोस्ट करें।

3) ऑडियो-केवल इनजेस्ट पाइपलाइन

1. फ्रंटेंड मान्य करता है कि उपयोगकर्ता ने mp3, m4a, flac, opus, wav में से एक का चयन किया है।
2. डाउनलोड एंडपॉइंट के माध्यम से कार्य शुरू करें।
3. पूर्ण होने पर, तुरंत डाउनस्ट्रीम ट्रांसक्रिप्शन या टैगिंग को सक्रिय करें, ऑडियो लिंक के लिए 2 घंटे की समाप्ति विंडो का ध्यान रखते हुए।

MCP के माध्यम से AI एजेंट से इस API का उपयोग करना

यदि आप AI एजेंट या MCP-संगत IDE से कॉल को समन्वयित करना पसंद करते हैं, तो आप Zyla के MCP गेटवे से कनेक्ट कर सकते हैं। MCP-सक्षम क्लाइंट जैसे Claude Code, Cursor, और Windsurf आपके Zyla API कुंजी का उपयोग करके मार्केटप्लेस APIs को कॉल कर सकते हैं। यहाँ MCP कनेक्शन विवरण की समीक्षा करें: MCP.

• अपने MCP क्लाइंट को MCP एंडपॉइंट पर इंगित करें और अपनी Zyla API कुंजी प्रदान करें।
• अपने उपकरण या एजेंट प्रॉम्प्ट में, इसे url और प्रारूप पैरामीटर के साथ डाउनलोड एंडपॉइंट URL पर GET अनुरोध करने के लिए निर्देशित करें, और Authorization: Bearer YOUR_API_KEY हेडर शामिल करें।
• प्रतिक्रिया से success, id, image, और progress_url को पार्स करें ताकि बाद की क्रियाओं (जैसे, पोलिंग या UI अपडेट) को चलाया जा सके।

परीक्षण चेकलिस्ट

• एंडपॉइंट को कॉल करने से पहले क्लाइंट-साइड पर YouTube URLs और प्रारूपों को मान्य करें।
• सफलता, id, image, और progress_url फ़ील्ड की पुष्टि करने के लिए 720p वीडियो के साथ एक परीक्षण कॉल करें।
• HTTP स्थिति कोड और टाइमआउट के चारों ओर बुनियादी त्रुटि हैंडलिंग लागू करें।
• निर्धारित करें कि कार्य id को कहाँ स्टोर करना है और progress_url की कितनी बार पोलिंग करनी है।
• यदि ऑडियो आउटपुट को उजागर कर रहे हैं, तो परिणामस्वरूप ऑडियो लिंक की 2 घंटे की समाप्ति के चारों ओर एक UX संकेत या अनुस्मारक लागू करें।

अक्सर पूछे जाने वाले प्रश्न

कौन से प्रारूप समर्थित हैं?
वीडियो: 360p, 480p, 720p, 1080p, 1440p, 2160p। ऑडियो: mp3, m4a, flac, opus, wav।

मैं प्रमाणीकरण कैसे करूं?
हर अनुरोध पर हेडर Authorization: Bearer YOUR_API_KEY शामिल करें।

क्या ऑडियो डाउनलोड लिंक समाप्त होते हैं?
हाँ। ऑडियो डाउनलोड लिंक 2 घंटे बाद समाप्त हो जाते हैं। अपने UX को तदनुसार डिज़ाइन करें।

क्या यह लाइव स्ट्रीम का समर्थन करता है?
यह एंडपॉइंट केवल नियमित वीडियो डाउनलोड का समर्थन करता है।

बिलिंग कैसे संभाली जाती है?
Zyla APIs एक सदस्यता + कोटा मॉडल का उपयोग करते हैं, प्रति कॉल भुगतान नहीं। वर्तमान पहुंच विकल्पों के लिए (जैसे, आपके पहले API के लिए 7-दिन की परीक्षण अवधि या 50 अनुरोध), मार्केटप्लेस लिस्टिंग की जांच करें।

इसे शिप करें

सदस्यता लें और ऊपर दिए गए cURL को चलाएं, फिर id, image, और progress_url को अपने कार्य ट्रैकर में जोड़ें। आप आज उत्पादन के लिए तैयार हो सकते हैं। यहाँ से शुरू करें: YouTube डाउनलोड और जानकारी API पर 7-दिन की परीक्षण अवधि शुरू करें.