आपको तेजी से विश्वसनीय इंस्टाग्राम प्रोफ़ाइल विवरण खींचने की आवश्यकता है—उपयोगकर्ता नाम, सत्यापन, अनुयायी संख्या, गोपनीयता स्थिति—ताकि आप उपयोगकर्ता रिकॉर्ड को समृद्ध कर सकें, एक साइनअप प्रवाह को शक्ति प्रदान कर सकें, या रचनाकारों को मान्य कर सकें। इस गाइड के अंत तक, आप एक अनुरोध में प्रोफ़ाइल डेटा प्राप्त करेंगे और जानेंगे कि जब आपको आवश्यकता हो तो पोस्ट, रील और हाइलाइट विवरण कैसे प्राप्त करें—सभी Zyla API Hub पर उसी API कुंजी के माध्यम से।
यह API आपको क्या देती है
इंस्टाग्राम प्रोफ़ाइल और मीडिया डेटा API प्रोफ़ाइल मेटाडेटा (id, उपयोगकर्ता नाम, अवतार URL, अनुयायी और अनुसरण करने वाले की संख्या, सत्यापन और गोपनीयता ध्वज, कुल पोस्ट) लौटाती है और आपको पोस्ट, रील और हाइलाइट कहानियों के लिए मीडिया विवरण प्राप्त करने की अनुमति देती है। टीमें इसका उपयोग करती हैं:
- रचनाकारों और भागीदारों को ऑनबोर्डिंग के दौरान मान्य करें।
- अनुयायी संख्या और सत्यापन स्थिति के साथ CRM रिकॉर्ड को समृद्ध करें।
- एक पोस्ट या रील URL को अभियान ट्रैकिंग के लिए आंकड़ों और लेखक की जानकारी में हल करें।
- हाइलाइट कहानियों के लिए सामग्री पिकर्स और डाउनलोड पाइपलाइनों का निर्माण करें।
सब कुछ Zyla API Hub के माध्यम से एकल सदस्यता और कुंजी के साथ चलता है। आप AI कोडिंग एजेंटों से MCP एंडपॉइंट का उपयोग करके इन एंडपॉइंट्स को भी कॉल कर सकते हैं।
Zyla API Hub पर शुरुआत करना
API पृष्ठ खोलें, सदस्यता लें, और अपनी कुंजी प्राप्त करें। नए खाते पर पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। प्रमाणीकरण HTTP हेडर Authorization: Bearer YOUR_API_KEY के माध्यम से है। बिलिंग सदस्यता + कोटा है, प्रति कॉल भुगतान नहीं।
इंस्टाग्राम प्रोफ़ाइल और मीडिया डेटा API पर 7-दिन की परीक्षण अवधि शुरू करें
एंडपॉइंट: प्रोफ़ाइल विवरण प्राप्त करें
इसका उपयोग तब करें जब आपको एक इंस्टाग्राम उपयोगकर्ता के लिए मुख्य पहचान और सार्वजनिक आँकड़े चाहिए। यह id, उपयोगकर्ता नाम, अवतार URL, जीवनी, श्रेणी, अनुयायी/अनुसरण करने वाले की संख्या, गोपनीयता और सत्यापन ध्वज, कुल पोस्ट, और उपलब्ध होने पर अधिक लौटाता है।
- विधि: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- आवश्यक पैरामीटर: उपयोगकर्ता नाम (स्ट्रिंग)
- प्रमाणन: Authorization: Bearer YOUR_API_KEY
cURL जिसे आप पेस्ट कर सकते हैं
curl -s -X GET "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details?username=a92_mm" \
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक उदाहरण प्रतिक्रिया
{
"data": {
"id": "8640409651",
"username": "a92_mm",
"fullName": "",
"avatarUrl": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/117330532_764310710994941_3178952573818498232_n.jpg?_nc_cat=105&ig_cache_key=GGRS-gb9R230IrcCALjsQ_iF6B0sbkULAAAB0j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy42NTYuQzMifQ%3D%3D&_nc_ohc=UhqRB5XucjcQ7kNvwHzZrZa&_nc_oc=AdqQKMjA1CNJE2cZFGaOKLPAekcrEXjIih5fmtbyZIyBJ-ZZBqfAyZouTn139aCO8yM&_nc_zt=24&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_ss=7b62e&oh=00_AQSK1vbEqHI8iXnKTfwnP4mNcPHclgCyRAq7u5j4Lij_Pg&oe=6AE96358",
"biography": "",
"category": "",
"bioLinks": [],
"linkedFacebookInfo": null,
"followerCount": 5,
"followingCount": 34,
"isPrivateAccount": true,
"isVerified": false,
"totalPosts": 9
}
}
आप जिन फ़ील्ड नोट्स का वास्तव में उपयोग करेंगे:
- id: स्थिर खाता पहचानकर्ता।
- उपयोगकर्ता नाम: वर्तमान हैंडल (बदल सकता है; दोनों id और उपयोगकर्ता नाम को स्टोर करें)।
- अवतार URL: रेंडरिंग के लिए सीधे CDN लिंक।
- अनुयायी संख्या, अनुसरण करने वाले की संख्या: वृद्धि ट्रैकिंग के लिए पूर्णांक।
- isPrivateAccount: यदि सत्य है, तो पोस्ट बिना अनुमति के सुलभ नहीं हैं; अपने UI को तदनुसार योजना बनाएं।
- isVerified: रचनाकार मान्यता के लिए बैज जांच।
- कुल पोस्ट: उच्च-स्तरीय गतिविधि संकेत।
Python उदाहरण (अनुरोध)
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details"
params = {"username": "a92_mm"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
data = resp.json()["data"]
print("ID:", data["id"])
print("Username:", data["username"])
print("Verified:", data["isVerified"])
print("Private:", data["isPrivateAccount"])
print("Followers:", data["followerCount"])
print("Following:", data["followingCount"])
print("Total posts:", data["totalPosts"])
print("Avatar URL:", data["avatarUrl"])
प्रोफ़ाइल-प्रेरित कार्यप्रवाह के लिए अन्य उपयोगी एंडपॉइंट्स
एक बार जब आपके पास किसी उपयोगकर्ता की प्रोफ़ाइल हो, तो आपको अक्सर विशिष्ट मीडिया में गहराई से जाने की आवश्यकता होगी। ये एंडपॉइंट्स आपको व्यक्तिगत पोस्ट, रील, या हाइलाइट कहानियों के लिए विवरण पृष्ठ प्राप्त करने में मदद करते हैं। सभी एक ही Authorization हेडर का उपयोग करते हैं और मीडिया-विशिष्ट फ़ील्ड लौटाते हैं; टाइमस्टैम्प यूनिक्स सेकंड हैं।
पोस्ट विवरण प्राप्त करें
- विधि: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- आवश्यक पैरामीटर: idOrUrl (स्ट्रिंग), उदाहरण के लिए एक पोस्ट URL जैसे https://www.instagram.com/p/DfALy1PTBSa/
यह क्या करता है: id या url का उपयोग करके एक विशिष्ट पोस्ट के बारे में विस्तृत जानकारी प्राप्त करें। प्रतिक्रिया में id, कोड, शीर्षक, createdAt (यूनिक्स सेकंड), लेखक वस्तु (id, उपयोगकर्ता नाम, पूर्ण नाम, isVerified, profilePictureUrl), totalMedia, statistics (likeCount, commentCount), और mediaList आइटम शामिल हैं जिनमें downloadUrl उपलब्ध होने पर शामिल है। इसका उपयोग एक साझा लिंक को लेखक मेटाडेटा और जुड़ाव आँकड़ों में हल करने के लिए करें।
रील विवरण प्राप्त करें
- विधि: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- आवश्यक पैरामीटर: idOrUrl (स्ट्रिंग), उदाहरण के लिए एक रील URL जैसे https://www.instagram.com/reel/DctYV2qt6S5/
यह क्या करता है: id या url का उपयोग करके एक विशिष्ट इंस्टाग्राम रील के बारे में विस्तृत जानकारी प्राप्त करें। प्रतिक्रिया में id, कोड, createdAt (यूनिक्स सेकंड), शीर्षक, लेखक वस्तु, आँकड़े (commentCount, likeCount), और लागू होने पर downloadUrl शामिल हैं। जब आपके पास केवल एक रचनाकार से रील लिंक हो तो अभियान रिपोर्टिंग के लिए महान।
हाइलाइट कहानी विवरण प्राप्त करें
- विधि: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- आवश्यक पैरामीटर: id (स्ट्रिंग), एक हाइलाइट ID जैसे 17910014403011985
यह क्या करता है: हाइलाइट ID का उपयोग करके एक विशिष्ट इंस्टाग्राम हाइलाइट के अंदर सभी कहानियाँ प्राप्त करें। प्रतिक्रिया में हाइलाइट का id, शीर्षक, totalStories, और एक कहानियों की सरणी शामिल होती है जिसमें id, mediaType, createdAt (यूनिक्स सेकंड), thumbnailUrl, और उपलब्ध होने पर downloadUrl शामिल होते हैं। इसका उपयोग हाइलाइट दर्शकों को रेंडर करने या एक हाइलाइट सेट का बैकअप लेने के लिए करें।
समय बचाने के लिए व्यावहारिक एकीकरण नोट्स
- प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY भेजें।
- टाइमस्टैम्प: createdAt फ़ील्ड यूनिक्स सेकंड हैं। अपने भाषा के मानक उपयोगिताओं के साथ परिवर्तित करें।
- निजी खाते: यदि isPrivateAccount सत्य है, तो अन्यत्र गायब या अनुपलब्ध मीडिया की अपेक्षा करें; इसे सुचारू रूप से संभालें।
- कैशिंग: प्रोफ़ाइल की गणनाओं को डुप्लिकेट कॉल को कम करने के लिए मिनटों के लिए कैश किया जा सकता है; अपने UI की ताजगी की आवश्यकताओं के अनुसार ट्यून करें।
- IDs बनाम URLs: पोस्ट और रील के लिए, idOrUrl आपको सीधे साझा लिंक पास करने देता है—आपके ऐप में कोई अतिरिक्त पार्सिंग चरण नहीं।
- डाउनलोड: मीडिया downloadUrl फ़ील्ड CDN लिंक की ओर इशारा करते हैं। ये समाप्त हो सकते हैं; मांग पर प्राप्त करें या उपयोग से पहले URLs को ताज़ा करें।
- कोटा: पहुंच सदस्यता + कोटा है। आपके खाते पर पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ आता है; लोड परीक्षण से पहले लिस्टिंग पृष्ठ पर पुष्टि करें।
वास्तविक दुनिया के प्रवाह
1) रचनाकार ऑनबोर्डिंग और सत्यापन
जब एक रचनाकार अपना इंस्टाग्राम उपयोगकर्ता नाम दर्ज करता है, तो isVerified, followerCount, और isPrivateAccount प्राप्त करने के लिए Get Profile Details को कॉल करें। स्वचालित रूप से निजी या कम-सिग्नल खातों को अस्वीकार करें या मैनुअल समीक्षा के लिए रूट करें। हैंडल परिवर्तनों को संभालने के लिए उपयोगकर्ता नाम के साथ id को स्टोर करें।
2) अभियान प्रदर्शन स्नैपशॉट
प्रभावशाली लोग पोस्ट या रील के लिए लिंक साझा करते हैं। उस लिंक को idOrUrl के माध्यम से Get Post Details या Get Reel Details में पास करें, फिर statistics.likeCount और statistics.commentCount को लेखक.username के साथ लॉग करें। प्रदर्शन इतिहास बनाए रखने के लिए समय-समय पर फिर से क्वेरी करें।
3) सामग्री पिकर्स और संपत्ति डाउनलोड
पोर्टफोलियो के लिए, Get Highlight Story Details के माध्यम से हाइलाइट सेट खींचें। thumbnailUrl के साथ कहानियाँ प्रदर्शित करें और यदि उपलब्ध हो तो उपयोगकर्ताओं को downloadUrl का उपयोग करके संपत्तियों को डाउनलोड करने की अनुमति दें। याद रखें कि CDN लिंक समाप्त हो सकते हैं; समय पर प्राप्त करें या डाउनलोड बटन को रेंडर करने से पहले लिंक को ताज़ा करें।
AI एजेंटों से MCP के माध्यम से API कॉल करना
यदि आप क्लॉड कोड, कर्सर, विंडसर्फ, या किसी भी MCP-संगत क्लाइंट का उपयोग करते हैं, तो आप एजेंट को MCP एंडपॉइंट के माध्यम से अपनी मौजूदा कुंजी के साथ Zyla APIs कॉल करने दे सकते हैं। अपनी API कुंजी प्रदान करें और एजेंट को ऊपर दिखाए गए समान GET अनुरोध जारी करने दें; Authorization हेडर वही रहता है। यह डेटा लुकअप को स्वचालित करने या प्राकृतिक भाषा संकेतों से एकीकरण कोड को स्कैफोल्डिंग करने के लिए उपयोगी है।
संदर्भ: सटीक अनुरोध URLs और पैरामीटर
- प्रोफ़ाइल विवरण प्राप्त करें (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- उपयोगकर्ता नाम (स्ट्रिंग, आवश्यक)
- पोस्ट विवरण प्राप्त करें (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- idOrUrl (स्ट्रिंग, आवश्यक), उदाहरण के लिए, https://www.instagram.com/p/DfALy1PTBSa/
- रील विवरण प्राप्त करें (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- idOrUrl (स्ट्रिंग, आवश्यक), उदाहरण के लिए, https://www.instagram.com/reel/DctYV2qt6S5/
- हाइलाइट कहानी विवरण प्राप्त करें (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- id (स्ट्रिंग, आवश्यक), उदाहरण के लिए, 17910014403011985
आप संदर्भित कर सकते हैं अन्य आधिकारिक उदाहरण
पोस्ट विवरण प्राप्त करें उदाहरण (हेडर में कोई परिवर्तन आवश्यक नहीं)
अनुरोध:
प्रतिक्रिया (उद्धरण):
रील विवरण प्राप्त करें उदाहरण (हेडर में कोई परिवर्तन आवश्यक नहीं)
अनुरोध:
प्रतिक्रिया (उद्धरण):
हाइलाइट कहानी विवरण प्राप्त करें उदाहरण (हेडर में कोई परिवर्तन आवश्यक नहीं)
अनुरोध:
प्रतिक्रिया (उद्धरण):
समस्या निवारण टिप्स
- 401 या 403 त्रुटियाँ: Authorization हेडर की पुष्टि करें और यह सुनिश्चित करें कि आपकी सदस्यता आपके खाते पर सक्रिय है।
- खाली फ़ील्ड: कुछ प्रोफ़ाइल में खाली जीवनी/श्रेणी या निजी होने पर सीमित फ़ील्ड होते हैं; nulls और खाली स्ट्रिंग्स को संभालें।
- समय समाप्त मीडिया URLs: यदि एक downloadUrl विफल हो जाता है, तो ताज़ा लिंक प्राप्त करने के लिए मीडिया विवरण को फिर से प्राप्त करें।
- गलत फ़ॉर्मेटेड URLs: जब idOrUrl का उपयोग करते हैं, तो पूर्ण कैनोनिकल इंस्टाग्राम URL पास करें; क्वेरी स्ट्रिंग बनाते समय URL-एन्कोड करें।
अक्सर पूछे जाने वाले प्रश्न
-
मैं अनुरोधों को कैसे प्रमाणित करूँ?
प्रत्येक अनुरोध के लिए हेडर में Authorization: Bearer YOUR_API_KEY भेजें।
-
क्या मैं उपयोगकर्ता नाम के बजाय ID द्वारा प्रोफ़ाइल प्राप्त कर सकता हूँ?
प्रोफ़ाइल एंडपॉइंट उपयोगकर्ता नाम स्वीकार करता है। आंतरिक कुंजी के लिए लौटाए गए id को स्टोर करें, लेकिन दिखाए गए अनुसार उपयोगकर्ता नाम द्वारा क्वेरी करें।
-
यदि मेरे पास केवल एक पोस्ट या रील के लिए साझा लिंक है तो क्या होगा?
Get Post Details या Get Reel Details पर idOrUrl के साथ सटीक इंस्टाग्राम लिंक का उपयोग करें। API इसे हल करता है और लेखक, आँकड़े, और मीडिया फ़ील्ड लौटाता है।
-
क्या टाइमस्टैम्प एक मानक प्रारूप में आते हैं?
हाँ। createdAt फ़ील्ड यूनिक्स टाइमस्टैम्प सेकंड में हैं। अपने ऐप में अपने स्थानीय समय क्षेत्र में परिवर्तित करें।
-
क्या कोई मुफ्त योजना है?
पहुंच सदस्यता + कोटा है। आपके खाते पर पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
क्या आप अपने एकीकरण को शिप करने के लिए तैयार हैं? इंस्टाग्राम प्रोफ़ाइल और मीडिया डेटा API पृष्ठ पर सदस्यता लें और अपनी कुंजी प्राप्त करें। आपकी 7-दिन की परीक्षण अवधि वहीं से शुरू होती है, और आप उसी कुंजी के साथ प्रोफ़ाइल, पोस्ट, रील, और हाइलाइट एंडपॉइंट्स को कॉल कर सकते हैं: इंस्टाग्राम प्रोफ़ाइल और मीडिया डेटा API पर 7-दिन की परीक्षण अवधि शुरू करें