वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए एपीआई

आपको इस सप्ताह एक सामाजिक मीडिया वीडियो यूआरएल को डाउनलोड करने योग्य फ़ाइल में बदलने के लिए एक विश्वसनीय तरीके की आवश्यकता है। इस गाइड के अंत तक, आप एक एपीआई को कॉल करेंगे ताकि आपके द्वारा चुने गए प्रारूप और रिज़ॉल्यूशन में एक वीडियो का अनुरोध किया जा सके, फिर एक दूसरे एपीआई को सीधे डाउनलोड यूआरएल प्राप्त करने के लिए पोल करें—जिसे संग्रहण में सहेजने, एक सीएमएस से संलग्न करने, या एक बैकग्राउंड वर्कर को सौंपने के लिए तैयार किया गया है।

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

सोशल मीडिया एपीआई वीडियो डाउनलोड एपीआई आपको यूट्यूब, फेसबुक, इंस्टाग्राम, साउंडक्लाउड, टिकटोक, एक्स/ट्विटर, और ट्विच जैसे प्लेटफार्मों से एक वीडियो यूआरएल सबमिट करने, एक लक्षित प्रारूप/गुणवत्ता चुनने, और फिर प्रोसेसिंग पूरी होने पर डाउनलोड करने योग्य लिंक प्राप्त करने की अनुमति देता है। यह लोकप्रिय रिज़ॉल्यूशनों और ऑडियो प्रारूपों का समर्थन करता है जिसमें 144, 240, 360, 480, 720, 1080, 1440, 4k, mp3, wav, ogg, और webm शामिल हैं। सामान्य उपयोग के मामले शामिल हैं:

• क्रिएटर द्वारा सबमिट किए गए यूआरएल को आपके मीडिया पाइपलाइन में स्वचालित रूप से समाहित करना
• एक मोबाइल ऐप के लिए एक विशिष्ट रिज़ॉल्यूशन में संपत्तियों को पूर्व-जनरेट करना
• पॉडकास्ट या ट्रांसक्रिप्शन वर्कफ़्लो के लिए केवल ऑडियो निकालना बनाना
• सोशल क्लिप को आर्काइव और श्रेणीबद्ध करने के लिए आंतरिक उपकरण बनाना

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

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

इस एकीकरण को जल्दी से शिप करने के लिए:

1. एपीआई की लिस्टिंग खोलें: सोशल मीडिया एपीआई वीडियो डाउनलोड एपीआई पर 7-दिन का परीक्षण शुरू करें.
2. सब्सक्राइब पर क्लिक करें या 7-दिन का परीक्षण शुरू करें (या 50 अनुरोध—जो वर्तमान में पेश किया गया है उसकी लिस्टिंग की जांच करें)।
3. अपनी एपीआई कुंजी कॉपी करें। प्रमाणीकरण एकल हेडर है: Authorization: Bearer YOUR_API_KEY.

बिलिंग सब्सक्रिप्शन + कोटा है, प्रति कॉल भुगतान नहीं। कोई मुफ्त योजना नहीं है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए, ऊपर एपीआई पृष्ठ की जांच करें। यदि आप बाद में अधिक मीडिया और सामाजिक एकीकरण ब्राउज़ करना चाहते हैं, तो Zyla API Hub पर जाएं।

एंडपॉइंट अवलोकन

यह एपीआई एक दो-चरणीय प्रवाह प्रदान करता है:

1. डाउनलोड के माध्यम से अपने इच्छित प्रारूप और गुणवत्ता में एक वीडियो का अनुरोध करें, जो आपके कार्य के लिए एक आईडी लौटाता है।
2. लगभग 30 सेकंड इंतजार करने के बाद, लौटाई गई आईडी का उपयोग करके वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए पोल करें।

1) डाउनलोड (प्रोसेसिंग के लिए एक वीडियो सबमिट करें)

• विधि: GET
• यूआरएल: https://zylalabs.com/api/10960/social-media-api-video-download/20671/download
• विवरण: किसी भी प्रारूप और गुणवत्ता में वीडियो डाउनलोड करें। यूट्यूब शॉर्ट्स के साथ भी काम करता है।
• समर्थित प्रारूप: 144, 240, 360, 480, 720, 1080, 1440, 4k, mp3, wav, ogg, webm
• समर्थित वेबसाइटें: यूट्यूब, फेसबुक, इंस्टाग्राम, साउंडक्लाउड, टिकटोक, एक्स/ट्विटर, ट्विच
• आवश्यक क्वेरी पैरामीटर:
  • download (string): स्रोत वीडियो यूआरएल (जैसे, यूट्यूब लिंक)
  • format (string): लक्षित प्रारूप या रिज़ॉल्यूशन (जैसे, 720)

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

curl -s -X GET "https://zylalabs.com/api/10960/social-media-api-video-download/20671/download?download=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D4iuPJ1pdNkY&format=720" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक JSON प्रतिक्रिया:

{
"success": true,
"id": "v2_stream_72b78f7ca6c4f1f267cb",
"title": "टीम फीचर: अल्जीरिया | "मज़ादोना," अल्जीरिया का गुप्त विश्व कप हथियार",
"thumbnail": "https://i.ytimg.com/vi/4iuPJ1pdNkY/hqdefault.jpg",
"format": "mp4 [720p]"
}

आपके एकीकरण के लिए क्या मायने रखता है:

• success: बूलियन जो इंगित करता है कि अनुरोध स्वीकार कर लिया गया था।
• id: प्रोसेसिंग पहचानकर्ता जिसे आप अगले एंडपॉइंट में उपयोग करेंगे। इसे बनाए रखें।
• title, thumbnail, format: लॉगिंग, यूएक्स, या फ़ाइल नामकरण के लिए सहायक।

2) वीडियो डाउनलोड यूआरएल प्राप्त करें (अंतिम लिंक के लिए पोल करें)

• विधि: GET
• यूआरएल: https://zylalabs.com/api/10960/social-media-api-video-download/20672/get-video-download-url
• विवरण: डाउनलोड चरण से आईडी का उपयोग करके डाउनलोड करने योग्य यूआरएल प्राप्त करें।
• महत्वपूर्ण: पिछले एंडपॉइंट से आईडी प्राप्त करने के बाद, आपको इसे यहां उपयोग करने से पहले 30 सेकंड इंतजार करना चाहिए। प्रोसेसिंग आमतौर पर 30 सेकंड से 1 मिनट लगती है और कतार के लोड के साथ भिन्न हो सकती है।
• आवश्यक क्वेरी पैरामीटर:
  • getVideo (string): डाउनलोड द्वारा लौटाई गई आईडी, जैसे, v2_stream_72b78f7ca6c4f1f267cb

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

आधिकारिक JSON प्रतिक्रिया:

आपके एकीकरण के लिए क्या मायने रखता है:

• status: यूआरएल का उपयोग करने का प्रयास करने से पहले "पूर्ण" की जांच करें।
• progress: एक पूर्णांक प्रगति संकेतक; पोलिंग बैकऑफ और यूएक्स के लिए उपयोगी।
• downloads: एक सरणी; "प्राइमरी" प्रकार के साथ वस्तु का उपयोग करें। इसका यूआरएल सीधे डाउनलोड लिंक है।

एंड-टू-एंड: अनुरोध करें, प्रतीक्षा करें, यूआरएल प्राप्त करें

डाउनलोड एंडपॉइंट प्रोसेसिंग को ट्रिगर करता है और एक आईडी लौटाता है। आपको फिर वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए कॉल करने से पहले कम से कम 30 सेकंड इंतजार करना चाहिए। कई टीमें बैकऑफ के साथ एक सरल पोलिंग लूप या एक निश्चित प्रतीक्षा और छोटे संख्या में पुनः प्रयास लागू करती हैं, जो आपके कार्यभार में कतार के समय पर निर्भर करती हैं।

पायथन उदाहरण

नीचे दिया गया नमूना दोनों चरणों को करता है। यह:

1. वीडियो यूआरएल और चुने हुए प्रारूप के साथ डाउनलोड के लिए GET भेजता है
2. 30 सेकंड प्रतीक्षा करता है
3. लौटाई गई आईडी के साथ वीडियो डाउनलोड यूआरएल प्राप्त करता है
4. उपलब्ध होने पर अंतिम डाउनलोड करने योग्य यूआरएल प्रिंट करता है

import time
import urllib.parse
import requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) एक विशिष्ट वीडियो और प्रारूप के लिए प्रोसेसिंग का अनुरोध करें
video_url = "https://www.youtube.com/watch?v=4iuPJ1pdNkY"
format_value = "720"

download_endpoint = (
"https://zylalabs.com/api/10960/social-media-api-video-download/20671/download"
)
params = {
"download": video_url,
"format": format_value,
}

resp = requests.get(download_endpoint, headers=HEADERS, params=params, timeout=60)
resp.raise_for_status()
data = resp.json()

if not data.get("success"):
raise RuntimeError(f"Download request failed: {data}")

job_id = data.get("id")
title = data.get("title")
fmt = data.get("format")
print(f"Requested: {title} ({fmt}), job id: {job_id}")

# 2) डाउनलोड यूआरएल प्राप्त करने से पहले कम से कम 30 सेकंड प्रतीक्षा करें
time.sleep(30)

poll_endpoint = (
"https://zylalabs.com/api/10960/social-media-api-video-download/20672/get-video-download-url"
)
poll_params = {"getVideo": job_id}

poll_resp = requests.get(poll_endpoint, headers=HEADERS, params=poll_params, timeout=60)
poll_resp.raise_for_status()
poll_data = poll_resp.json()

status = poll_data.get("status")
progress = poll_data.get("progress")
print(f"Status: {status}, progress: {progress}")

downloads = poll_data.get("downloads") or []
primary = next((d for d in downloads if d.get("type") == "primary"), None)

if primary and primary.get("url"):
print(f"Download URL: {primary['url']}")
else:
print("No download URL yet. Try polling again after a short delay.")

व्यावहारिक एकीकरण नोट्स

• पोलिंग कैडेंस: एपीआई नोट करता है कि आपको आईडी प्राप्त करने के बाद 30 सेकंड प्रतीक्षा करनी चाहिए। यदि आपको मजबूती की आवश्यकता है, तो 30–45 सेकंड प्रतीक्षा करें, फिर एक बार पोल करें। यदि स्थिति "पूर्ण" नहीं है, तो प्रतीक्षा करें और फिर से पोल करें। नमूना प्रतिक्रिया पूर्ण होने पर प्रगति को 100 दिखाती है।
• प्रारूप: प्रारूप पैरामीटर 720, 1080, 4k जैसे वीडियो गुणवत्ता के लिए और mp3, wav, ogg, webm जैसे ऑडियो या कंटेनर विकल्पों के लिए प्रविष्टियों को स्वीकार करता है। अपने संग्रहण और प्लेबैक लक्ष्यों के आधार पर चुनें।
• समर्थित स्रोत: यूट्यूब, फेसबुक, इंस्टाग्राम, साउंडक्लाउड, टिकटोक, एक्स/ट्विटर, और ट्विच। यदि आप एक सार्वभौमिक डाउनलोडर यूआई बना रहे हैं, तो एपीआई को भेजने से पहले इनपुट यूआरएल के डोमेन को मान्य करें।
• मेटाडेटा हैंडलिंग: डाउनलोड प्रतिक्रिया से शीर्षक और थंबनेल आपके यूआई में पूर्वावलोकनों के लिए उपयोगी होते हैं जबकि प्रोसेसिंग चल रही होती है; इन्हें कार्य आईडी के साथ कैश करें।
• संग्रहण: वीडियो डाउनलोड यूआरएल प्रतिक्रिया सीधे लिंक को downloads[0].url (जहां प्रकार "प्राइमरी" है) में लौटाती है। परिणामी फ़ाइल को अपने ऑब्जेक्ट स्टोरेज में सहेजें या इसे अपने मीडिया पाइपलाइन को सौंपें।
• त्रुटि हैंडलिंग: यदि सफलता गलत है या स्थिति इंगित करती है कि कार्य तैयार नहीं है, तो तंग लूप से बचें। अनावश्यक अनुरोधों को कम करने के लिए एक्सपोनेंशियल बैकऑफ लागू करें।
• कोटा: पहुंच सब्सक्रिप्शन + कोटा के माध्यम से है, प्रति कॉल भुगतान नहीं। अपने ज़ाइला डैशबोर्ड और एपीआई लिस्टिंग में शेष कोटा की जांच करें; कोटा को बचाने के लिए अधिक पोलिंग से बचें।

वास्तविक दुनिया के कार्यप्रवाह

क्रिएटर अपलोड के साथ यूआरएल सामान्यीकरण

जब एक क्रिएटर एक सामग्री यूआरएल सबमिट करता है, तो आपका बैकएंड कर सकता है:

1. यूआरएल डोमेन को पार्स और मान्य करें (यह समर्थित साइटों में से एक होना चाहिए)।
2. मोबाइल-फ्रेंडली बेसलाइन के लिए format=720 के साथ डाउनलोड कॉल करें।
3. आईडी, शीर्षक, और थंबनेल को स्टोर करें और उपयोगकर्ता को "डाउनलोड तैयार कर रहा है" स्थिति दिखाएं।
4. 30–60 सेकंड के बाद, वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए पोल करें और अंतिम यूआरएल को डिलीवरी या आगे की प्रोसेसिंग के लिए "तैयार" स्थिति में बनाए रखें।

ट्रांसक्रिप्शन या पॉडकास्टिंग के लिए ऑडियो निकालना

यदि आपको केवल ऑडियो की आवश्यकता है, तो प्रारूप को mp3, wav, या ogg पर सेट करें। फिर अपनी ट्रांसक्रिप्शन सेवा चलाएं या ऑडियो को अपने फीड जनरेटर से संलग्न करें। इससे आपको केवल ऑडियो की आवश्यकता होने पर पूर्ण-रिज़ॉल्यूशन वीडियो फ़ाइल प्राप्त करने से बचने में मदद मिलती है।

संपादकीय क्यूरेशन के लिए बैच इनजेस्ट

साप्ताहिक क्यूरेशन कार्यों के लिए, वीडियो यूआरएल को एक कार्य कतार में डालें। श्रमिक पहले डाउनलोड कार्यों का अनुरोध करते हैं, फिर कम से कम 30 सेकंड के लिए सोते हैं, और अंततः वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए पोल करते हैं। संपादकीय पूर्वावलोकनों के लिए शीर्षक और थंबनेल को बनाए रखें।

एक एआई एजेंट (एमसीपी) से एपीआई कॉल करना

यदि आप एक एमसीपी-संगत क्लाइंट (जैसे, क्लॉड कोड, कर्सर, विंडसर्फ) के माध्यम से कॉल को समन्वयित करना पसंद करते हैं, तो आप ज़ाइला एमसीपी एंडपॉइंट के माध्यम से अनुरोधों को रूट कर सकते हैं। एमसीपी कनेक्शन को प्रारंभ करते समय क्वेरी पैरामीटर के माध्यम से अपनी कुंजी प्रदान करें और ऊपर दिखाए गए समान हब यूआरएल को कॉल करें जिसमें प्रमाणीकरण हेडर हो।

दस्तावेज़ और प्रवेश बिंदु: MCP. यह एआई एजेंटों को आपके ज़ाइला एपीआई कुंजी का उपयोग करके प्रमाणीकरण के लिए, आपके एजेंट के उपकरण निष्पादन वातावरण के भीतर, पहले देखे गए सटीक GET अनुरोधों को सक्रिय करने की अनुमति देता है।

प्रारूप कैसे चुनें और समय प्रबंधन करें

• रिज़ॉल्यूशनों का चयन: 720 वेब और मोबाइल के लिए एक मजबूत डिफ़ॉल्ट है। स्मार्ट टीवी ऐप या संपादकीय मास्टर के लिए 1080 या उच्चतर का उपयोग करें। यदि बैंडविड्थ सीमित है, तो 360 या 480 ट्रांसफर आकार को कम करता है।
• ऑडियो प्रारूपों का चयन: mp3 व्यापक रूप से समर्थित है; wav बिना संकुचित पाइपलाइनों के लिए सुविधाजनक हो सकता है; ogg कुछ ओपन-सोर्स स्टैक्स के लिए उपयुक्त है।
• समय प्रबंधन पर विचार: सेवा नोट करती है कि आईडी प्राप्त करने के बाद 30 सेकंड की आवश्यक प्रतीक्षा होती है। प्रोसेसिंग आमतौर पर कतार के लोड के आधार पर लगभग 30 सेकंड से 1 मिनट में पूरी होती है। अपने श्रमिकों को इस देरी को सुचारू रूप से संभालने के लिए डिज़ाइन करें।

सुरक्षा और विश्वसनीयता टिप्स

• प्राधिकरण: हर कॉल पर हमेशा Authorization: Bearer YOUR_API_KEY शामिल करें। कुंजी को अपने सीक्रेट मैनेजर में रखें।
• यूआरएल हैंडलिंग: क्वेरी स्ट्रिंग्स के ट्रंकशन से बचने के लिए डाउनलोड पैरामीटर के लिए मानक यूआरएल एन्कोडिंग का उपयोग करें (जैसे आधिकारिक cURL में)।
• पुनः प्रयास: नेटवर्क कॉल अस्थायी रूप से विफल हो सकते हैं। 5xx प्रतिक्रियाओं या टाइमआउट पर बैकऑफ के साथ सीमित पुनः प्रयास लागू करें, विशेष रूप से पोलिंग चरण के लिए।
• पर्यवेक्षण: डाउनलोड कॉल करते समय कार्य आईडी, शीर्षक, और चुने हुए प्रारूप को लॉग करें। पोलिंग करते समय, धीमापन और कतार के स्पाइक्स की पहचान करने के लिए स्थिति और प्रगति को लॉग करें।
• संग्रहण जीवनचक्र: अंतिम यूआरएल प्राप्त करने और मीडिया को स्टोर करने के बाद, अपने सिस्टम में मूल लिंक को समाप्त करने पर विचार करें और डाउनस्ट्रीम सर्विंग के लिए अपने स्वयं के संग्रहण पर भरोसा करें।

त्वरित संदर्भ: पैरामीटर और प्रतिक्रियाएँ

डाउनलोड

• HTTP विधि: GET
• यूआरएल: https://zylalabs.com/api/10960/social-media-api-video-download/20671/download
• आवश्यक पैरामीटर:
  • download: पूर्ण वीडियो यूआरएल (जैसे, https://www.youtube.com/watch?v=4iuPJ1pdNkY)
  • format: वांछित प्रारूप या गुणवत्ता (जैसे, 720, 1080, 4k, mp3, wav, ogg, webm)
• प्रमाणन: Authorization: Bearer YOUR_API_KEY
• प्रतिक्रिया फ़ील्ड:
  • success: बूलियन
  • id: अगले चरण के लिए कार्य पहचानकर्ता
  • title: वीडियो शीर्षक
  • thumbnail: थंबनेल यूआरएल
  • format: मानव-पठनीय प्रारूप वर्णनकर्ता

वीडियो डाउनलोड यूआरएल प्राप्त करें

• HTTP विधि: GET
• यूआरएल: https://zylalabs.com/api/10960/social-media-api-video-download/20672/get-video-download-url
• आवश्यक पैरामीटर:
  • getVideo: डाउनलोड चरण से आईडी
• प्रमाणन: Authorization: Bearer YOUR_API_KEY
• व्यवहार: पहले कॉल से पहले 30 सेकंड प्रतीक्षा करें; प्रोसेसिंग आमतौर पर 30–60 सेकंड लगती है।
• प्रतिक्रिया फ़ील्ड:
  • success: बूलियन
  • status: जैसे, "पूर्ण"
  • progress: पूर्णांक प्रतिशत
  • downloads: प्रकार, यूआरएल, और has_ssl के साथ वस्तुओं की सरणी

सामान्य समस्याओं का समाधान

• तत्काल पोलिंग कोई यूआरएल नहीं लौटाती: सुनिश्चित करें कि आपने डाउनलोड प्रतिक्रिया के बाद कम से कम 30 सेकंड प्रतीक्षा की। यदि अभी भी अधूरा है, तो प्रतीक्षा करें और फिर से पोल करें।
• असमर्थित यूआरएल: सुनिश्चित करें कि डोमेन समर्थित वेबसाइटों में से एक है (यूट्यूब, फेसबुक, इंस्टाग्राम, साउंडक्लाउड, टिकटोक, एक्स/ट्विटर, ट्विच)। भेजने से पहले यूआरएल को सामान्यीकृत या मान्य करें।
• गलत प्रारूप: समर्थित प्रारूपों में से एक का उपयोग करें जैसा कि सूचीबद्ध है (जैसे, 720, 1080, 4k, mp3, wav, ogg, webm)। स्वीकृत मानों में निर्दिष्ट किए बिना फ़ाइल एक्सटेंशन जोड़ने से बचें।
• कोटा पार किया: एपीआई सब्सक्रिप्शन + कोटा है। अपने ज़ाइला डैशबोर्ड में उपयोग की निगरानी करें और यदि आवश्यक हो तो अपग्रेड करें।

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

क्या मुझे वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए कॉल करने से पहले कितना इंतजार करना चाहिए?
डाउनलोड एंडपॉइंट से आईडी प्राप्त करने के बाद कम से कम 30 सेकंड प्रतीक्षा करें। प्रोसेसिंग आमतौर पर 30 सेकंड से 1 मिनट में पूरी होती है, जो कतार के लोड पर निर्भर करती है।

कौन सी साइटें समर्थित हैं?
यूट्यूब, फेसबुक, इंस्टाग्राम, साउंडक्लाउड, टिकटोक, एक्स/ट्विटर, और ट्विच।

मैं कौन से प्रारूपों का अनुरोध कर सकता हूँ?
144, 240, 360, 480, 720, 1080, 1440, 4k, mp3, wav, ogg, webm।

कौन सा प्रमाणीकरण आवश्यक है?
हर अनुरोध पर हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

क्या यह प्रति कॉल भुगतान है?
नहीं। पहुंच सब्सक्रिप्शन + कोटा है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।

इसे शिप करें

यदि आप आज सामाजिक लिंक को डाउनलोड करने योग्य मीडिया में बदलने के लिए तैयार हैं, तो इस गाइड में दो एंडपॉइंट्स के साथ शुरू करें और उन्हें अपने कार्यकर्ता या वेबहुक प्रवाह में वायर करें। अपना खाता बनाएं और यहां एक कुंजी प्राप्त करें: सोशल मीडिया एपीआई वीडियो डाउनलोड एपीआई पर 7-दिन का परीक्षण शुरू करें. फिर अपने ऐप के प्रदर्शन लक्ष्यों से मेल खाने के लिए प्रारूपों और पोलिंग अंतराल पर पुनरावृत्ति करें।