API to get stories and reels

आपको Instagram कहानियों या रीलों के URL को प्रोग्रामेटिक रूप से प्राप्त करने की आवश्यकता है ताकि डाउनस्ट्रीम प्रोसेसिंग—पूर्वावलोकन रेंडरिंग, सामग्री को मॉडरेट करने, या स्टोरेज में संपत्तियों को सहेजने—के लिए, और आपको यह इस सप्ताह काम करने की आवश्यकता है। इस गाइड के अंत तक, आपके पास एक उत्पादन एंडपॉइंट का कार्यशील कॉल होगा जो एक सार्वजनिक Instagram कहानी या रील URL लेता है और मीडिया पेलोड लौटाता है, Zyla API Hub से एक API कुंजी का उपयोग करते हुए।

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

Instagram कहानियों डाउनलोडर API एक केंद्रित क्षमता को उजागर करती है: एक Instagram रील या कहानी के URL को दिए जाने पर, यह अंतर्निहित मीडिया को हल करने और लौटाने का प्रयास करती है। यह निम्नलिखित के लिए उपयोगी है:

• सोशल मीडिया शेड्यूलर बनाना जिन्हें फिर से पोस्ट करने से पहले स्रोत मीडिया प्राप्त करने की आवश्यकता होती है।
• सामग्री मॉडरेशन वर्कफ़्लो जो स्वचालित जांच के लिए मीडिया निकालते हैं।
• बैकअप और आर्काइविंग सेवाएँ जो उपयोगकर्ता द्वारा प्रस्तुत Instagram लिंक को संरक्षित करती हैं।
• डेटा इनजेशन पाइपलाइन्स जिन्हें प्रोसेसिंग के लिए निश्चित मीडिया URLs की आवश्यकता होती है।

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

Zyla API Hub पर शुरुआत करना

API कुंजी प्राप्त करने के लिए:

1. Instagram कहानियों डाउनलोडर API के लिए मार्केटप्लेस लिस्टिंग खोलें और परीक्षण शुरू करें।
2. अपनी API कुंजी प्राप्त करने के लिए सदस्यता लें।
3. Authorization: Bearer YOUR_API_KEY के साथ एंडपॉइंट को कॉल करें।

शुरू करने के लिए इस सीधे लिंक का उपयोग करें: Instagram कहानियों डाउनलोडर API पर 7-दिन का परीक्षण शुरू करें। आप Zyla API Hub पर अन्य सोशल मीडिया APIs को भी ब्राउज़ कर सकते हैं।

एंडपॉइंट: कहानियाँ और रीलें प्राप्त करें

यह API एक प्रदान किए गए Instagram कहानी या रील URL से मीडिया प्राप्त करने के लिए एकल एंडपॉइंट को उजागर करती है।

• विधि: GET
• URL: https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels
• आवश्यक क्वेरी पैरामीटर:
  • url (string): कहानी या रील का पूरा Instagram URL। उदाहरण: https://www.instagram.com/reel/DL74pQBRymc/
• प्रमाणीकरण: HTTP हेडर Authorization: Bearer YOUR_API_KEY

महत्वपूर्ण: अनुरोध बनाते समय url पैरामीटर को URL-एन्कोड करें। नीचे दिया गया उदाहरण पहले से ही उचित एन्कोडिंग शामिल करता है।

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

curl -s -X GET "https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDL74pQBRymc%2F" \
-H "Authorization: Bearer YOUR_API_KEY"

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

{
"media": [],
"error": "Invalid Instagram link format! Currently, we support images, reels, and IGTV only."
}

फील्ड नोट्स:

• media: एक एरे जो तब हल किए गए मीडिया ऑब्जेक्ट्स को रखने के लिए अभिप्रेत है जब URL मान्य और समर्थित हो।
• error: एक संदेश जो बताता है कि जब समाधान विफल होता है तो क्या गलत हुआ (जैसे, असमर्थित या गलत फ़ॉर्मेट वाला URL)।

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

कार्यशील Python उदाहरण

नीचे दिया गया स्निपेट उसी एंडपॉइंट को कॉल करता है, JSON को पार्स करता है, और बुनियादी त्रुटि हैंडलिंग का प्रदर्शन करता है। YOUR_API_KEY को अपने Zyla API Hub सदस्यता से अपनी वास्तविक कुंजी से बदलें।

import requests
import urllib.parse

API_KEY = "YOUR_API_KEY"
endpoint = "https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels"

# हमेशा `url` क्वेरी पैरामीटर के लिए Instagram लिंक को URL-एन्कोड करें
ing_link = "https://www.instagram.com/reel/DL74pQBRymc/"
params = {
"url": urllib.parse.quote(ig_link, safe="")
}

# API की अपेक्षा के अनुसार एन्कोडेड पैरामीटर के साथ अंतिम URL बनाएं
final_url = f"{endpoint}?url={params['url']}"

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

resp = requests.get(final_url, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

# न्यूनतम पार्सिंग: यदि `error` मौजूद है तो प्राथमिकता दें, अन्यथा `media` का उपयोग करें
if data.get("error"):
print("API ने त्रुटि की सूचना दी:", data["error"])
else:
media_items = data.get("media", [])
print(f"हल किए गए {len(media_items)} मीडिया आइटम(s)।")
# आइटम का उदाहरण पुनरावृत्ति (आइटम की संरचना API प्रतिक्रिया पर निर्भर करती है)
for i, item in enumerate(media_items, 1):
# यहाँ फ़ील्ड्स को दस्तावेज़ित नहीं किया गया है इसलिए डिक्ट एक्सेस को सावधानी से उपयोग करें
# जैसे, संभावित कुंजी में 'url', 'type', आदि शामिल हो सकते हैं (लाइव प्रतिक्रियाओं की जांच करें)
print(f"आइटम {i}: {item}")

डेवलपर नोट्स जो समय बचाते हैं

• URL एन्कोडिंग: जब Instagram URL को url क्वेरी पैरामीटर के रूप में भेजते हैं तो हमेशा एन्कोड करें। ऊपर दिया गया curl सही एन्कोडिंग दिखाता है।
• प्रमाणीकरण: एकल हेडर का उपयोग करें—Authorization: Bearer YOUR_API_KEY। अपनी कुंजी को क्वेरी स्ट्रिंग में न रखें।
• इनपुट मान्यता: सुनिश्चित करें कि उपयोगकर्ता पूर्ण Instagram URLs प्रदान करते हैं जो रीलों या कहानियों का प्रतिनिधित्व करते हैं। उदाहरण प्रतिक्रिया असमर्थित या गलत फ़ॉर्मेट वाले लिंक के साथ आप जो त्रुटि संदेश देख सकते हैं, उसे प्रदर्शित करती है।
• पुनः प्रयास: यदि आपको अस्थायी HTTP त्रुटियाँ मिलती हैं, तो पीछे हटें और पुनः प्रयास करें। JSON बॉडी में लगातार त्रुटि फ़ील्ड पर, इसे उपयोगकर्ता को प्रदर्शित करें बजाय इसके कि पुनः प्रयास करें।
• कैशिंग: यदि आपका वर्कफ़्लो बार-बार लोकप्रिय लिंक को प्रोसेस करता है, तो सफल मीडिया समाधान को कैनोनिकल Instagram URL द्वारा कैश करें ताकि डुप्लिकेट अनुरोधों को कम किया जा सके।
• कोटा: पहुँच सदस्यता + कोटा है (पे-पर-कॉल नहीं)। इस API के लिए आप 7-दिन के परीक्षण या 50 अनुरोधों के साथ शुरू कर सकते हैं; लोड परीक्षण से पहले लिस्टिंग पृष्ठ पर अपने वर्तमान सीमाओं की पुष्टि करें।

व्यावहारिक उपयोग के मामले

1) सामाजिक सामग्री इनजेशन

उपयोगकर्ताओं को एक रील URL पेस्ट करने दें; मीडिया को हल करें; इसे अपने स्टोरेज में अपलोड करें; मेटाडेटा संलग्न करें; रूपांतरण के लिए कतारबद्ध करें (जैसे, ट्रांसकोडिंग, क्लिपिंग, या थंबनेल जनरेशन)। जब URL असमर्थित हो तो स्पष्ट संकेत दिखाकर त्रुटि पथ को संभालें।

2) मॉडरेशन पाइपलाइन

एक रील या कहानी लिंक से मीडिया को हल करें, फिर इसे अपने मॉडरेशन स्टैक के माध्यम से चलाएँ। एकल Instagram URL के साथ लगातार इनपुट के साथ, आप अपनी सेवाओं में प्रोसेसिंग और लॉगिंग को मानकीकृत कर सकते हैं।

3) निर्माता उपकरण

एक सरल "Instagram से आयात करें" फीचर बनाएं, रीलों को एक संपादक समयरेखा में हल करें। जब API असमर्थित लिंक फ़ॉर्मेट को त्रुटि फ़ील्ड के माध्यम से चिह्नित करता है तो तात्कालिक फीडबैक प्रदान करें।

4) आर्काइव और बैकअप

जब उपयोगकर्ता संदर्भ के रूप में लिंक प्रदान करते हैं, तो इस एंडपॉइंट का उपयोग करके मीडिया प्राप्त करें और इसे प्रामाणिकता के साथ आर्काइव करें। ऑडिट करने के लिए मूल Instagram URL और समाधान टाइमस्टैम्प को स्टोर करें।

MCP के माध्यम से AI एजेंट से इसे कॉल करने का तरीका

Zyla पर हर API को मॉडल संदर्भ प्रोटोकॉल (MCP) के माध्यम से भी कॉल किया जा सकता है, जो MCP-संगत उपकरणों के साथ काम करता है। अपने क्लाइंट को MCP गेटवे पर इंगित करें: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

अपने MCP क्लाइंट के भीतर, एक उपकरण कॉन्फ़िगर करें जो GET अनुरोध करता है:

• https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels
• हेडर: Authorization: Bearer YOUR_API_KEY
• क्वेरी पैरामीटर: url (URL-एन्कोडेड Instagram लिंक)

एक बार कनेक्ट होने के बाद, आपका एजेंट एक रील/कहानी URL को इनपुट के रूप में स्वीकार कर सकता है और आपके कोडिंग सत्र में पार्स की गई JSON (मीडिया या त्रुटि) लौटाता है। MCP पर संदर्भ सामग्री के लिए, देखें: MCP.

एंड-टू-एंड चेकलिस्ट

• लिस्टिंग पृष्ठ पर सदस्यता लेकर API कुंजी प्राप्त करें।
• सुनिश्चित करें कि Instagram URL को url के रूप में पास करते समय URL-एन्कोड किया गया है।
• हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
• त्रुटि के लिए JSON की जांच करें; यदि मौजूद है, तो यह मान न लें कि मीडिया उपलब्ध है।
• डीबगिंग और ऑडिट के लिए मूल इनपुट URL और API प्रतिक्रिया को लॉग करें।
• कैनोनिकल Instagram URL द्वारा कुंजीबद्ध सफल समाधानों को कैश करें।

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

एंडपॉइंट किन सामग्री प्रकारों का समर्थन करता है?
त्रुटि संदेश छवियों, रीलों और IGTV के लिए समर्थन को इंगित करता है। यदि आप एक फ़ॉर्मेट पास करते हैं जो API द्वारा समर्थित नहीं है या एक अमान्य लिंक, तो एक त्रुटि संदेश की अपेक्षा करें जैसे कि उदाहरण प्रतिक्रिया में।

मैं प्रमाणीकरण कैसे करूँ?
एक HTTP हेडर शामिल करें: Authorization: Bearer YOUR_API_KEY। क्वेरी स्ट्रिंग में कुंजी शामिल न करें।

क्या मुझे Instagram लिंक को URL-एन्कोड करना चाहिए?
हाँ। url क्वेरी पैरामीटर में एक URL-एन्कोडेड Instagram लिंक होना चाहिए। आधिकारिक curl उदाहरण सही एन्कोडिंग दिखाता है।

जब API त्रुटि फ़ील्ड लौटाता है तो मुझे क्या करना चाहिए?
उस अनुरोध के लिए त्रुटि को प्राधिकृत परिणाम के रूप में मानें। उपयोगकर्ता को एक मान्यता संदेश दिखाएं, सुधार की अनुमति दें, या लॉग करें और प्रोसेसिंग को रोकें। यदि त्रुटि असमर्थित फ़ॉर्मेट को इंगित करती है तो पुनः प्रयास करने से बचें।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। पहुँच सदस्यता + कोटा है, जिसमें 7-दिन के परीक्षण या 50 अनुरोधों का पहला चरण विकल्प है। वर्तमान पहुँच विकल्पों के लिए API पृष्ठ की जांच करें।

क्या आप अपने Instagram रील/कहानी एकीकरण को भेजने के लिए तैयार हैं? यहाँ अपने परीक्षण को शुरू करें और अपनी API कुंजी प्राप्त करें: Zyla API Hub पर Instagram कहानियों डाउनलोडर API। एक बार सदस्यता लेने के बाद, आप मिनटों में अपना पहला अनुरोध कर सकते हैं और प्रतिक्रिया को अपने सामाजिक वर्कफ़्लो में प्लग कर सकते हैं।