आपको Instagram से पोस्ट डेटा प्राप्त करने के लिए एक API की आवश्यकता है—विशेष रूप से, एक सार्वजनिक पोस्ट URL इनपुट करने के लिए और मीडिया, आयाम, और पहचानकर्ता प्राप्त करने के लिए जिन्हें आप इस सप्ताह अपने ऐप में भेज सकते हैं। इस गाइड के अंत तक, आप एक URL से Instagram पोस्ट/प्रकाशन डेटा प्राप्त करने, उपयोगकर्ता नाम द्वारा खाता डेटा खींचने, और Instagram डेटा API का उपयोग करके शॉर्टकोड द्वारा रील मैट्रिक्स प्राप्त करने में सक्षम होंगे, जिसमें कॉपी-पेस्ट करने योग्य curl और Python उदाहरण शामिल हैं।
यह API आपको क्या देती है और कब इसका उपयोग करें
Instagram डेटा API तीन केंद्रित पढ़ने वाले एंडपॉइंट्स को उजागर करता है:
- पोस्ट डेटा प्राप्त करें: एक सार्वजनिक Instagram पोस्ट URL प्रदान करें और पोस्ट/प्रकाशन डेटा प्राप्त करें, जिसमें मीडिया URLs, आयाम, और पहचानकर्ता शामिल हैं।
- खाता डेटा प्राप्त करें: एक उपयोगकर्ता नाम प्रदान करें और Instagram खाता डेटा प्राप्त करें, जिसमें जीवनी और बायो लिंक शामिल हैं।
- रील डेटा प्राप्त करें: एक पोस्ट/रील शॉर्टकोड प्रदान करें और सार्वजनिक सगाई मैट्रिक्स जैसे लाइक्स, टिप्पणियाँ, और वीडियो व्यू काउंट प्राप्त करें।
सामान्य उपयोगों में सामग्री अधिग्रहण पाइपलाइनों, लिंक अनफर्लिंग, मीडिया पूर्वावलोकन निर्माण, विश्लेषणात्मक डैशबोर्ड, और मॉडरेशन कतारें शामिल हैं। आप वही URL या शॉर्टकोड भेजते हैं जो आपके पास पहले से है; API आपके UI या कार्यप्रवाह को शक्ति देने के लिए संरचित फ़ील्ड लौटाती है।
API Zyla API Hub पर उपलब्ध है, जो 10,000 से अधिक सार्वजनिक APIs के साथ एक मार्केटप्लेस है, जो एक खाते, एक API कुंजी, और एक सदस्यता + कोटा मॉडल (पे-पर-कॉल नहीं) के तहत एकीकृत है। इस API के लिए, पहली सदस्यता 7-दिन का परीक्षण प्रदान करती है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए लिस्टिंग की जांच करें।
Zyla API Hub पर शुरुआत करना
- Instagram डेटा API लिस्टिंग खोलें: Instagram डेटा API पर 7-दिन का परीक्षण शुरू करें.
- सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें) और अपनी API कुंजी प्राप्त करें।
- Authorization हेडर में कुंजी का उपयोग करें जैसे: Authorization: Bearer YOUR_API_KEY.
इस लेख में सभी अनुरोध Zyla Hub एंडपॉइंट URLs को लक्षित करते हैं। कोई मूल होस्ट, SDK, या अतिरिक्त प्रमाणीकरण पैरामीटर की आवश्यकता नहीं है—बस अपने बियरर टोकन और प्रलेखित क्वेरी पैरामीटर के साथ HTTPS GET अनुरोध भेजें।
एंडपॉइंट: पोस्ट डेटा प्राप्त करें (URL द्वारा)
सार्वजनिक पोस्ट URL पास करके Instagram पोस्ट/प्रकाशन डेटा प्राप्त करें। उपयोगी जब आपका सिस्टम एक लिंक (उदाहरण के लिए, एक उपयोगकर्ता सबमिशन से) संग्रहीत या प्राप्त करता है और आपको पहचानकर्ता, मीडिया URLs, और आयामों की आवश्यकता होती है।
- विधि: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/630/get-post-data
- आवश्यक क्वेरी पैरामीटर:
- link (string): एक सार्वजनिक Instagram पोस्ट URL, उदाहरण के लिए https://www.instagram.com/p/BsOGulcndj- (क्वेरी स्ट्रिंग में URL-एन्कोडेड होना चाहिए)
curl उदाहरण (कॉपी-पेस्ट)
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/630/get-post-data?link=https%3A%2F%2Fwww.instagram.com%2Fp%2FBsOGulcndj-" \
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक नमूना प्रतिक्रिया
{
"status": true,
"__typename": "GraphImage",
"id": "1949525278281554174",
"shortcode": "BsOGulcndj-",
"dimensions": {
"height": 584,
"width": 584
},
"gating_info": null,
"fact_check_overall_rating": null,
"fact_check_information": null,
"sensitivity_friction_info": null,
"sharing_friction_info": {
"should_have_sharing_friction": false,
"bloks_app_url": null
},
"media_overlay_info": null,
"media_preview": null,
"display_url": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=instagram.fbcn2-1.fna.fbcdn.net&_nc_cat=105&_nc_oc=Q6cZ2gHBlHY2RHKNTgCNzMelAyz56Toi4DI7VUNsrK7XJAsoGT6ka4w7PVJ6IEqS7PD9Ulw&_nc_ohc=jwkKyc7eqGAQ7kNvwHmuCEW&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&edm=AOmX9WgBAAAA&ccb=7-5&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&oh=00_AQONRzWv-s9IPALJK9qeJ5FVyMcHbwpYaGsJhb7fdlV1nA&oe=6ACE9A40&_nc_sid=bfaa47",
"display_resources": [
{
"src": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e35_s360x360_sh2.08_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNTg0LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=53XaOqCZWBYQ7kNvwFfkQTV&_nc_oc=AdprbrBLkElSfmNNOrQHEYQuCIz8F8lIlYN7TENXKNGCcZVnybmvx0uXH6fzElyfwak&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fbcn2-1.fna&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&_nc_ss=7a3ba&oh=00_AQNBRrpvxf3JGSktIaicSqaD4UtCuDo9I8feI6acpRs9Eg&oe=6ACE9A40",
"config_width": 360,
"config_height": 360
},
{
"src": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNTg0LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=53XaOqCZWBYQ7kNvwFfkQTV&_nc_oc=AdprbrBLkElSfmNNOrQHEYQuCIz8F8lIlYN7TENXKNGCcZVnybmvx0uXH6fzElyfwak&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fbcn2-1.fna&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&_nc_ss=7a3ba&oh=00_AQMhFQizLfIe4bAcskLHhT2nCDcjFGyldOq2Cp7IMLuVxg&oe=6ACE9A40",
"config_width": 584,
"config_height": 584
}
],
"accessibility_caption…आप आमतौर पर जिन प्रमुख फ़ील्ड्स का उपयोग करेंगे:
- id और shortcode: डुप्लिकेशन और अनुक्रमण के लिए स्थिर पहचानकर्ता।
- __typename: पोस्ट प्रकार (जैसे, GraphImage)।
- dimensions.height और dimensions.width: रेंडर योजना और उत्तरदायी आकार।
- display_url: पूर्वावलोकन या प्रसंस्करण के लिए सीधा मीडिया URL।
- display_resources: वैकल्पिक आकार; अपने लक्षित दृश्यपटल के निकटतम का चयन करें।
Python उदाहरण
यह उदाहरण Get Post Data को सटीक URL के साथ कॉल करता है और पहचानकर्ता, आयाम, और मीडिया URL पढ़ता है। नोट: लिंक पैरामीटर को URL-एन्कोडेड होना चाहिए। नीचे दिया गया कोड curl उदाहरण के समान एन्कोडेड URL का उपयोग करता है।
import requests
API_URL = "https://zylalabs.com/api/855/instagram-data-api/630/get-post-data"
LINK_PARAM = "https%3A%2F%2Fwww.instagram.com%2Fp%2FBsOGulcndj-"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(f"{API_URL}?link={LINK_PARAM}", headers=HEADERS, timeout=30)
resp.raise_for_status()
data = resp.json()
# Extract fields commonly used in apps
post_id = data.get("id")
shortcode = data.get("shortcode")
typename = data.get("__typename")
dims = data.get("dimensions") or {}
height = dims.get("height")
width = dims.get("width")
display_url = data.get("display_url")
print({
"id": post_id,
"shortcode": shortcode,
"type": typename,
"height": height,
"width": width,
"display_url": display_url
})समय बचाने वाले कार्यान्वयन नोट्स
- URL एन्कोडिंग: क्वेरी बनाते समय लिंक पैरामीटर को एन्कोड करें। यदि आप गतिशील रूप से URLs बना रहे हैं, तो डबल-एन्कोडिंग से बचने के लिए अंतर्निहित URL एन्कोडर्स को प्राथमिकता दें।
- कैशिंग: सूची दृश्य में एक ही पोस्ट को बार-बार पुनः प्राप्त करने से बचने के लिए पोस्ट id और shortcode को display_url के साथ संग्रहीत करें।
- मीडिया वैरिएंट: क्लाइंट-साइड रिसाइजिंग को कम करने के लिए अपने लक्षित आयामों के निकट display_resources आकार का चयन करें।
- त्रुटि हैंडलिंग: यदि कोई पोस्ट अनुपलब्ध या निजी हो जाती है, तो अपने रेंडरिंग पाइपलाइन में nulls या गायब फ़ील्ड की अपेक्षा करें।
एंडपॉइंट: खाता डेटा प्राप्त करें (उपयोगकर्ता नाम द्वारा)
उपयोगकर्ता नाम का उपयोग करके Instagram खाता डेटा प्राप्त करें। प्रोफ़ाइल कार्ड, लिंक पूर्वावलोकन, और ऑनबोर्डिंग सत्यापन के लिए उपयोगी।
- विधि: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/631/get-account-data
- आवश्यक क्वेरी पैरामीटर:
- username (string): Instagram हैंडल, उदाहरण के लिए, leomessi
curl उदाहरण
आधिकारिक नमूना प्रतिक्रिया (संक्षिप्त)
UI में विचार करने के लिए फ़ील्ड:
- जीवनी: प्रोफ़ाइल हेडर या होवरकार्ड में दिखाएँ।
- bio_links: एक सत्यापित बाहरी लिंक की सूची रेंडर करें; सीधे नेविगेशन के लिए URL को प्राथमिकता दें।
एंडपॉइंट: रील डेटा प्राप्त करें (शॉर्टकोड द्वारा)
इसके शॉर्टकोड का उपयोग करके एक सार्वजनिक Instagram पोस्ट या रील के लिए मैट्रिक्स प्राप्त करें। विश्लेषणात्मक टाइलों, रैंकिंग सूचियों, और KPI निगरानी के लिए आदर्श।
- विधि: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/32007/get-reel-data
- आवश्यक क्वेरी पैरामीटर:
- shortcode (string): उदाहरण के लिए, DctYV2qt6S5
curl उदाहरण
आधिकारिक नमूना प्रतिक्रिया
व्यावहारिक नोट्स:
- engagement visualizations को चलाने के लिए video_view_count और play_count का उपयोग करें; यदि दोनों एक साथ मौजूद हैं, तो अपने ऐतिहासिक डेटा सेट के साथ समानता के लिए दोनों को बनाए रखें।
- कोड वही मान है जिसे आपने शॉर्टकोड के रूप में पास किया; इसे अपने सामग्री कुंजी के साथ संग्रहीत करें ताकि बाद में इसे फिर से हल करने से बचा जा सके।
आपके एकीकरण को डिजाइन करना
पोस्ट URLs के लिए न्यूनतम अधिग्रहण प्रवाह
- एक उपयोगकर्ता या फ़ीड से एक सार्वजनिक Instagram URL प्राप्त करें।
- URL-एन्कोडेड लिंक के साथ Get Post Data को कॉल करें।
- id, shortcode, आयाम, और display_url को अपने डेटाबेस में बनाए रखें।
- जहां उपलब्ध हो, display_resources से रेंडर करें ताकि आपके लेआउट से मेल खा सके।
अज्ञात शॉर्टकोड को हल करना
यदि आपके पास केवल एक URL है और आपको डाउनस्ट्रीम विश्लेषण के लिए शॉर्टकोड की आवश्यकता है (उदाहरण के लिए, Get Reel Data को कॉल करने के लिए), तो पहले Get Post Data को कॉल करें। प्रतिक्रिया में शॉर्टकोड शामिल है; इसे संग्रहीत करें ताकि आप आवश्यकता पड़ने पर Get Reel Data का उपयोग करके मैट्रिक्स प्राप्त कर सकें।
पुनः प्रयास और टाइमआउट
- क्लाइंट टाइमआउट: एक संवेदनशील टाइमआउट सेट करें (जैसे, 30s जैसा दिखाया गया है) और यदि आपका ऐप लेटेंसी-टॉलरेंट है तो एक बार idempotent GETs का पुनः प्रयास करें।
- बैकऑफ: अस्थायी नेटवर्क समस्याओं के लिए गुणात्मक बैकऑफ लागू करें।
सुरक्षा और उत्पादन तत्परता
- प्रमाणीकरण: हमेशा HTTPS पर Authorization: Bearer YOUR_API_KEY भेजें।
- कुंजी प्रबंधन: अपनी कुंजी को एक सीक्रेट्स मैनेजर या env वेरिएबल में रखें। इसे क्लाइंट को न भेजें।
- कोटा: API एक सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। अपने Zyla डैशबोर्ड में उपयोग की निगरानी करें और लोकप्रिय परिणामों को कैश करें ताकि पुनरावृत्ति कॉल को कम किया जा सके।
AI एजेंट (MCP) से इस API को कॉल करना
आप Zyla के मॉडल संदर्भ प्रोटोकॉल एंडपॉइंट के माध्यम से AI एजेंटों से इन समान हब एंडपॉइंट्स को कॉल कर सकते हैं। यह Claude Code, Cursor, और Windsurf जैसे MCP-संगत क्लाइंट के साथ काम करता है।
- MCP सर्वर एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
- अपने एजेंट के भीतर, MCP सर्वर को कॉन्फ़िगर करें और इसे उसी API कुंजी से अधिकृत करें।
- एजेंट के उपकरणों से, इस लेख में दिखाए गए हब URLs पर आवश्यक क्वेरी पैरामीटर और Authorization हेडर के साथ GET अनुरोध जारी करें।
MCP उपयोग के बारे में अधिक जानकारी के लिए, देखें: MCP.
वास्तविक दुनिया के उपयोग के मामले
- मॉडरेशन कतार: जब एक उपयोगकर्ता Instagram लिंक सबमिट करता है, तो मीडिया और आयामों को प्राप्त करने के लिए Get Post Data को कॉल करें ताकि एक समीक्षक UI बिना मैनुअल स्क्रीनशॉटिंग के हो सके।
- लिंक अनफर्लिंग: चैट या टिप्पणियों में, Instagram URLs का पता लगाएं और display_url और आयामों के साथ पूर्वावलोकन को समृद्ध करें ताकि स्पष्ट थंबनेल मिल सकें।
- क्रिएटर डैशबोर्ड: प्रत्येक रील के लिए शॉर्टकोड संग्रहीत करें और like_count, comment_count, और video_view_count टाइलों को अपडेट करने के लिए समय-समय पर Get Reel Data को ताज़ा करें।
- प्रोफ़ाइल ऑनबोर्डिंग: खाता कनेक्ट करने पर, जीवनी और bio_links के साथ प्रोफ़ाइल कार्ड को हाइड्रेट करने के लिए उपयोगकर्ता नाम द्वारा Get Account Data को कॉल करें।
समस्या निवारण चेकलिस्ट
- 401 Unauthorized: Authorization हेडर को ठीक से सत्यापित करें जैसे Authorization: Bearer YOUR_API_KEY.
- खाली या आंशिक फ़ील्ड: सुनिश्चित करें कि लिंक या शॉर्टकोड मान्य और सार्वजनिक है; निजी या हटा दिए गए सामग्री पूर्ण डेटा नहीं लौटाएंगे।
- खराब क्वेरी पैरामीटर: पुष्टि करें कि आपने Get Post Data के लिए link, Get Account Data के लिए username, और Get Reel Data के लिए shortcode का उपयोग किया है, जहां लागू हो वहां उचित URL एन्कोडिंग के साथ।
- ओवर-कोटा व्यवहार: यह API सदस्यता + कोटा का उपयोग करता है; अपने डैशबोर्ड और API लिस्टिंग की वर्तमान आवंटन और विकल्पों के लिए जांच करें।
एंड-टू-एंड स्निपेट: लिंक में, पूर्वावलोकन बाहर
लिंक-टू-पोस्ट प्रवाह को एक सहायक में संयोजित करें जिसे आप एक बैकएंड रूट में डाल सकते हैं। यह ऊपर प्रदर्शित एंडपॉइंट और पैरामीटर का उपयोग करता है।
import os
import urllib.parse
import requests
API_KEY = os.getenv("ZYLA_API_KEY")
BASE_URL = "https://zylalabs.com/api/855/instagram-data-api/630/get-post-data"
def fetch_instagram_post(link: str):
params = {"link": urllib.parse.quote(link, safe="")}
url = f'{BASE_URL}?link={params["link"]}'
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get(url, headers=headers, timeout=30)
r.raise_for_status()
data = r.json()
return {
"id": data.get("id"),
"shortcode": data.get("shortcode"),
"type": data.get("__typename"),
"width": (data.get("dimensions") or {}).get("width"),
"height": (data.get("dimensions") or {}).get("height"),
"display_url": data.get("display_url"),
}
# उदाहरण उपयोग:
# preview = fetch_instagram_post("https://www.instagram.com/p/BsOGulcndj-")
# print(preview)अक्सर पूछे जाने वाले प्रश्न
कौन सी प्रमाणीकरण आवश्यक है?
प्रत्येक अनुरोध के साथ Authorization: Bearer YOUR_API_KEY भेजें।
क्या मुझे URL से शॉर्टकोड निकालने की आवश्यकता है?
नहीं। Get Post Data के लिए, लिंक में पूर्ण पोस्ट URL पास करें। यदि आपको बाद में ऐसे मैट्रिक्स की आवश्यकता है जो शॉर्टकोड का उपयोग करते हैं, तो Get Post Data प्रतिक्रिया से शॉर्टकोड पढ़ें और इसे Get Reel Data में पास करें।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। API एक सदस्यता + कोटा मॉडल का उपयोग करती है। लिस्टिंग 7-दिन का परीक्षण प्रदान करती है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
कौन से फ़ील्ड्स को मुझे कैश करना चाहिए?
पोस्ट के लिए id, shortcode, आयाम, और display_url कैश करें; रील के लिए, यदि आप विश्लेषणात्मक या ट्रेंडिंग सूचियाँ बना रहे हैं तो like_count, comment_count, और video_view_count के साथ शॉर्टकोड कैश करें।
क्या मैं AI कोडिंग उपकरणों से API को कॉल कर सकता हूँ?
हाँ। अपने API कुंजी के साथ MCP एंडपॉइंट का उपयोग करें, और एजेंट को यहां वर्णित हब URLs पर समान GET अनुरोध जारी करने दें।
शिप करने के लिए तैयार? अपना खाता बनाएं, एक API कुंजी प्राप्त करें, और यहां Instagram डेटा API पर 7-दिन का परीक्षण शुरू करें: Instagram डेटा API पर 7-दिन का परीक्षण शुरू करें. कभी भी Zyla API Hub पर अधिक APIs का अन्वेषण करें।
