आपको इस सप्ताह Instagram प्रोफ़ाइल विवरण खींचने के लिए एक API की आवश्यकता है। इस गाइड के अंत तक, आप एक उपयोगकर्ता की प्रोफ़ाइल (id, username, counts, verification, privacy) प्राप्त करेंगे, और आप जानेंगे कि Zyla API Hub पर उत्पादन-तैयार एंडपॉइंट्स का उपयोग करके रील, पोस्ट और हाइलाइट कहानियों को कैसे पढ़ना है।
इस API से आपको क्या मिलता है
Instagram प्रोफ़ाइल और मीडिया डेटा API पढ़ने के लिए केवल एंडपॉइंट्स को उजागर करता है:
- उपयोगकर्ता नाम द्वारा प्रोफ़ाइल विवरण: id, अवतार, बायो, अनुयायी/अनुसरण करने वाले गिनती, सत्यापन और गोपनीयता फ़्लैग, और कुल पोस्ट।
- URL या id द्वारा पोस्ट विवरण: शीर्षक, लेखक, गिनती, मीडिया सूची, और डाउनलोड लिंक।
- URL या id द्वारा रील विवरण: लेखक, गिनती, शीर्षक, निर्माण समय, और एक डाउनलोड URL।
- हाइलाइट id द्वारा हाइलाइट कहानी विवरण: शीर्षक, कुल कहानियाँ, और प्रत्येक कहानी का मीडिया प्रकार, टाइमस्टैम्प, थंबनेल, और डाउनलोड लिंक।
ये एंडपॉइंट्स उपयोगकर्ता-फेसिंग प्रोफाइल, CRM और समृद्धि डैशबोर्ड, सामग्री मॉडरेशन/समीक्षा उपकरण, और मीडिया इनजेशन वर्कफ़्लोज़ को शक्ति प्रदान करते हैं जहाँ आपको एक सार्वजनिक Instagram संसाधन को संरचित फ़ील्ड में हल करना होगा जिसे आप कैश और अनुक्रमित कर सकते हैं।
Zyla API Hub पर शुरू करना
API के लिए मार्केटप्लेस पृष्ठ खोलें, सदस्यता लें, और अपनी कुंजी प्राप्त करें। पहला API 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। प्रमाणीकरण HTTP हेडर के माध्यम से है: Authorization: Bearer YOUR_API_KEY.
- Instagram प्रोफ़ाइल और मीडिया डेटा API पर 7-दिन का परीक्षण शुरू करें
- 10,000 से अधिक सार्वजनिक APIs पर ब्राउज़ करें Zyla API Hub
एंडपॉइंट: प्रोफ़ाइल विवरण प्राप्त करें
दिए गए Instagram उपयोगकर्ता नाम के लिए प्रोफ़ाइल डेटा प्राप्त करें।
- विधि: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- आवश्यक क्वेरी पैरामीटर:
- username (string) — Instagram हैंडल जिसे हल करना है
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
}
}नोट्स:
- गिनती पूर्णांक हैं जिन्हें आप सीधे प्रदर्शित कर सकते हैं।
- isPrivateAccount नियंत्रित करता है कि क्या आपको UI पूर्वावलोकन के लिए मीडिया खींचने का प्रयास करना चाहिए।
- avatarUrl एक CDN URL है जो सीधे रेंडरिंग के लिए उपयुक्त है; कैशिंग पर विचार करें।
Python उदाहरण
यह नमूना उसी एंडपॉइंट को कॉल करता है और उन फ़ील्ड्स को निकालता है जिन्हें आप आमतौर पर स्टोर करेंगे।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
USERNAME = "a92_mm"
url = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details"
params = {"username": USERNAME}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json().get("data", {})
profile = {
"id": data.get("id"),
"username": data.get("username"),
"full_name": data.get("fullName"),
"avatar_url": data.get("avatarUrl"),
"bio": data.get("biography"),
"followers": data.get("followerCount"),
"following": data.get("followingCount"),
"is_private": data.get("isPrivateAccount"),
"is_verified": data.get("isVerified"),
"total_posts": data.get("totalPosts"),
}
print(profile)एंडपॉइंट: पोस्ट विवरण प्राप्त करें
एक id या एक कैनोनिकल Instagram URL का उपयोग करके एक विशिष्ट पोस्ट के बारे में विस्तृत जानकारी प्राप्त करें।
- विधि: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- आवश्यक क्वेरी पैरामीटर:
- idOrUrl (string) — उदाहरण के लिए https://www.instagram.com/p/DfALy1PTBSa/
cURL उदाहरण
प्रतिक्रिया id, कोड, शीर्षक, createdAt (Unix युग सेकंड), लेखक (id, username, fullName, isVerified, profilePictureUrl), totalMedia, statistics (likeCount, commentCount), और डाउनलोडUrl प्रविष्टियों के साथ mediaList जैसे फ़ील्ड लौटाती है।
एंडपॉइंट: रील विवरण प्राप्त करें
id या URL द्वारा एक विशिष्ट Instagram रील के बारे में विस्तृत जानकारी प्राप्त करें।
- विधि: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- आवश्यक क्वेरी पैरामीटर:
- idOrUrl (string) — उदाहरण के लिए https://www.instagram.com/reel/DctYV2qt6S5/
cURL उदाहरण
प्रतिक्रिया शीर्ष-स्तरीय फ़ील्ड जैसे id, कोड, createdAt (Unix युग सेकंड), शीर्षक, statistics (commentCount, likeCount), लेखक (id, username, fullName, isVerified, profilePictureUrl), और एक डाउनलोडUrl शामिल करती है।
एंडपॉइंट: हाइलाइट कहानी विवरण प्राप्त करें
हाइलाइट id का उपयोग करके एक विशिष्ट Instagram हाइलाइट के अंदर सभी कहानियाँ प्राप्त करें।
- विधि: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- आवश्यक क्वेरी पैरामीटर:
- id (string) — हाइलाइट id, उदाहरण के लिए 17910014403011985
cURL उदाहरण
प्रतिक्रिया हाइलाइट-स्तरीय फ़ील्ड जैसे id, शीर्षक, totalStories, और प्रत्येक कहानी के id, mediaType (IMAGE या VIDEO), createdAt (Unix युग सेकंड), thumbnailUrl, और downloadUrl के साथ एक कहानियों की सूची लौटाती है।
व्यावहारिक कार्यान्वयन नोट्स
- टाइमस्टैम्प: createdAt मान Unix युग सेकंड हैं। प्रदर्शित करने पर अपने ऐप के समय क्षेत्र में परिवर्तित करें।
- कैशिंग: प्रोफ़ाइल फ़ील्ड और लेखक अवतार कम बार बदलते हैं; मिनटों से घंटों तक कैश करें। मीडिया URLs CDN लिंक हैं और समाप्त हो सकते हैं; आवश्यकतानुसार ताज़ा करें।
- गोपनीयता: यदि isPrivateAccount सत्य है, तो यह मान न लें कि आप अन्य एंडपॉइंट्स के माध्यम से मीडिया तक पहुँच सकते हैं। अपने UI और बैकग्राउंड कार्यों की सुरक्षा करें।
- मीडिया हैंडलिंग: downloadUrl फ़ील्ड सीधे लिंक हैं। ईग्रस को कम करने के लिए अपने API के माध्यम से प्रॉक्सी करने के बजाय स्टोरेज में स्ट्रीम करें।
- त्रुटि हैंडलिंग: गैर-2xx को अस्थायी के रूप में मानें जब तक कि आप पहले से उपयोगकर्ता नाम/URL को मान्य न करें। अनुरोधित उपयोगकर्ता नाम या idOrUrl और HTTP स्थिति को लॉग करें।
- कोटा: बिलिंग सदस्यता + कोटा है, प्रति कॉल भुगतान नहीं। अपने कॉल की गिनती को ट्रैक करें और योजना की सीमाओं के भीतर रहने के लिए कैशिंग का उपयोग करें।
एंड-टू-एंड कार्यप्रवाह उदाहरण
साइन-अप फॉर्म के लिए प्रोफ़ाइल समृद्धि
- उपयोगकर्ता आपके उत्पाद में एक Instagram हैंडल दर्ज करता है।
- उपयोगकर्ता नाम के साथ Get Profile Details को कॉल करें और id, followerCount, isPrivateAccount, isVerified, और avatarUrl को स्टोर करें।
- अपने UI में अवतार और सत्यापन बैज को रेंडर करें। जब isPrivateAccount सत्य हो तो मीडिया पूर्वावलोकन को अक्षम करें।
संपादकीय इनजेशन पाइपलाइन
- संपादक आपके CMS में एक पोस्ट URL चिपकाता है।
- idOrUrl के साथ Get Post Details को कॉल करें और शीर्षक, author.username, statistics.likeCount, और mediaList[0].downloadUrl को निकालें।
- मीडिया को downloadUrl के माध्यम से लाने के लिए एक डाउनलोडर को कतारबद्ध करें और इसे अपने CDN में स्टोर करें। त्वरित पृष्ठ लोड के लिए पोस्ट मेटाडेटा को कैश करें।
रील एनालिटिक्स स्नैपशॉट
- रात का कार्य रील URLs की एक सूची को दोहराता है।
- प्रवृत्ति चार्ट के लिए timestamp के साथ statistics.commentCount और statistics.likeCount को सहेजने के लिए प्रत्येक के लिए Get Reel Details को कॉल करें।
हाइलाइट गैलरी
- एक ज्ञात हाइलाइट id के साथ, Get Highlight Story Details को कॉल करें।
- createdAt द्वारा कालानुक्रमिक क्रम में कहानियों को सूचीबद्ध करें। ग्रिड पूर्वावलोकन के लिए thumbnailUrl का उपयोग करें और क्लिक के पीछे पूर्ण आकार के अनुरोधों को गेट करें।
AI एजेंटों से MCP के माध्यम से API कॉल करें
हर Zyla API MCP-संगत डेवलपर उपकरण (Claude Code, Cursor, Windsurf, आदि) से उपलब्ध है, जो MCP एंडपॉइंट पर है: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY। यह आपको एक एजेंट को उसी Instagram एंडपॉइंट्स को कॉल करने के लिए वायर करने की अनुमति देता है जो आपने ऊपर देखे बिना एजेंट के अंदर कस्टम नेटवर्क कोड को रोल किए बिना।
अधिक जानें और यहाँ MCP एंडपॉइंट में अपनी कुंजी लगाएँ: MCP.
Zyla के साथ इसे क्यों भेजें
- एक खाता, एक कुंजी, एक सदस्यता हर API के लिए जिसे आप अपने स्टैक में जोड़ते हैं।
- संगत Bearer प्रमाणीकरण और हब-होस्टेड एंडपॉइंट्स, ताकि आप प्रति-विक्रेता SDKs को न संभालें।
- कभी भी अधिक क्षमताएँ जोड़ें Zyla API Hub पर ब्राउज़ करके और उसी बिलिंग पहचान के साथ सदस्यता लेकर।
फ़ील्ड मैपिंग चीट शीट
- प्रोफाइल: id, username, fullName, avatarUrl, biography, followerCount, followingCount, isPrivateAccount, isVerified, totalPosts।
- पोस्ट: id, कोड, शीर्षक, createdAt, author{ id, username, fullName, isVerified, profilePictureUrl }, totalMedia, statistics{ likeCount, commentCount }, mediaList[ ]।
- रील: id, कोड, createdAt, शीर्षक, statistics{ commentCount, likeCount }, author{ ... }, downloadUrl।
- हाइलाइट कहानियाँ: id, शीर्षक, totalStories, कहानियाँ[ { id, mediaType, createdAt, thumbnailUrl, downloadUrl } ]।
शिपिंग चेकलिस्ट
- स्थिर विदेशी कुंजियों के लिए प्रोफ़ाइल id को उपयोगकर्ता नाम के साथ स्टोर करें।
- टाइमस्टैम्प को UTC में सामान्यीकृत करें और क्लाइंट पर प्रारूपित करें।
- अस्थायी HTTP त्रुटियों पर बैकऑफ और पुनः प्रयास करें; 4xx पर वैधता के साथ शॉर्ट-सर्किट करें।
- प्रोफ़ाइल विवरण और लेखक चित्रों को कैश करें; एक TTL सेट करें जो आपकी कोटा में फिट बैठता है।
- isPrivateAccount के साथ मीडिया फ़ेच को सुरक्षित करें और खाली मीडिया सूचियों को सुरक्षित रूप से संभालें।
अक्सर पूछे जाने वाले प्रश्न
इस API में कौन सा प्रमाणीकरण है?
प्रत्येक अनुरोध पर हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।
क्या मैं प्रोफाइल के लिए उपयोगकर्ता नाम द्वारा और मीडिया के लिए URL द्वारा क्वेरी कर सकता हूँ?
हाँ। Get Profile Details उपयोगकर्ता नाम का उपयोग करता है। Get Post Details और Get Reel Details idOrUrl स्वीकार करते हैं, इसलिए आप एक कैनोनिकल Instagram URL पास कर सकते हैं।
तारीखें किस समय क्षेत्र में हैं?
createdAt फ़ील्ड Unix युग सेकंड (UTC) हैं। अपने उपयोगकर्ता के समय क्षेत्र में क्लाइंट-साइड पर परिवर्तित करें।
बिलिंग कैसे संभाली जाती है?
Zyla सदस्यता + कोटा का उपयोग करता है, प्रति कॉल भुगतान नहीं। पहला API 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
क्या मैं इन एंडपॉइंट्स को AI कोडिंग एजेंट से कॉल कर सकता हूँ?
हाँ। https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर MCP एंडपॉइंट का उपयोग करें। देखें: MCP.
प्रोफ़ाइल लुकअप और मीडिया फ़ेच को लागू करने के लिए तैयार हैं? अपना खाता बनाएं, एक API कुंजी प्राप्त करें, और लिस्टिंग पृष्ठ पर अपने 7-दिन के परीक्षण की शुरुआत करें: Instagram प्रोफ़ाइल और मीडिया डेटा API पर 7-दिन का परीक्षण शुरू करें.
