पोस्ट विवरण के लिए API

आपको एक URL के लिए प्रोग्रामेटिक रूप से पूर्ण Instagram पोस्ट विवरण (शीर्षक/कैप्शन, लेखक, गिनती, मीडिया URL) प्राप्त करने की आवश्यकता है जो आपके पास पहले से है। इस गाइड के अंत तक, आप एकल एंडपॉइंट से उन फ़ील्ड को पुनः प्राप्त करेंगे, उन्हें कोड में पार्स करेंगे, और जानेंगे कि रील और हाइलाइट कहानियों के लिए कहाँ जाना है - सभी Zyla API Hub पर एक API कुंजी का उपयोग करके।

आप इस API के साथ क्या बनाएंगे

Instagram प्रोफ़ाइल और मीडिया डेटा API उन संरचित विवरणों को लौटाता है जो आप पहले से URL या ID द्वारा जानते हैं। आप कर सकते हैं:

• एक पोस्ट URL को उसके ID, कैप्शन/शीर्षक, लेखक की जानकारी, लाइक/टिप्पणी की गिनती, और मीडिया डाउनलोड URLs में हल करें।
• URL द्वारा एक रील देखें और इसके लेखक, सगाई, और डाउनलोड करने योग्य मीडिया लिंक पढ़ें।
• एक Instagram हाइलाइट (हाइलाइट ID द्वारा) को इसके व्यक्तिगत कहानियों में मीडिया URLs के साथ विस्तारित करें।

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

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

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

Instagram प्रोफ़ाइल और मीडिया डेटा API पर 7-दिन का परीक्षण शुरू करें

एक कुंजी के साथ Zyla API Hub, आप श्रेणियों में हजारों APIs को कॉल कर सकते हैं। वही सब्सक्रिप्शन मॉडल और कुंजी मार्केटप्लेस में लागू होते हैं।

आपके लिए आया एंडपॉइंट: पोस्ट विवरण प्राप्त करें

एक विशिष्ट Instagram पोस्ट के बारे में विस्तृत जानकारी प्राप्त करें, इसके URL (या ID जो आपके पास पहले से है) का उपयोग करके।

• विधि: GET
• अनुरोध URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
• आवश्यक क्वेरी पैरामीटर: idOrUrl (string)

उदाहरण: पोस्ट URL पास करें।

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
}
}

कार्यान्वयनकर्ताओं के लिए फ़ील्ड नोट्स:

• data.id और data.code पोस्ट की पहचान करते हैं; कोड /p/{code} पथ से मानचित्रित होता है।
• data.title पोस्ट कैप्शन/शीर्षक है। इसे UTF‑8 के रूप में स्टोर करें।
• data.createdAt एक यूनिक्स टाइमस्टैम्प (सेकंड) है। अपने समय क्षेत्र प्रबंधन में आवश्यकतानुसार परिवर्तित करें।
• data.author में मानक उपयोगकर्ता नाम, सत्यापन स्थिति, और अवतार URL शामिल हैं।
• data.statistics.likeCount और commentCount सगाई मैट्रिक्स प्रदान करते हैं।
• data.mediaList में डाउनलोड करने योग्य मीडिया URLs होते हैं जिन्हें आप सीधे प्राप्त कर सकते हैं। गंतव्य होस्ट की कैशिंग और लिंक समाप्ति नीतियों का सम्मान करें; यदि आपको स्थिर संपत्तियों की आवश्यकता है तो अपने पक्ष पर हल की गई फ़ाइल को कैश करें।

Python उदाहरण: URL द्वारा एक पोस्ट प्राप्त करें और प्रमुख फ़ील्ड पढ़ें

import os
import requests
from datetime import datetime, timezone

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
POST_URL = "https://www.instagram.com/p/DfALy1PTBSa/"

endpoint = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details"
params = {"idOrUrl": POST_URL}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(endpoint, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json().get("data", {})

post_id = data.get("id")
code = data.get("code")
title = data.get("title", "")
created_at = data.get("createdAt")
dt = datetime.fromtimestamp(created_at, tz=timezone.utc) if created_at else None

author = data.get("author", {})
username = author.get("username")
is_verified = author.get("isVerified")

stats = data.get("statistics", {})
likes = stats.get("likeCount")
comments = stats.get("commentCount")

media = data.get("mediaList", [])
first_download_url = media[0].get("downloadUrl") if media else None

print("Post:", post_id, code)
print("Author:", username, "(verified)" if is_verified else "")
print("Caption:", title)
print("Created at (UTC):", dt)
print("Engagement: likes =", likes, ", comments =", comments)
print("First media URL:", first_download_url)

अन्य उपलब्ध एंडपॉइंट्स जिन्हें आपको अगली आवश्यकता हो सकती है

यदि आपका एकीकरण स्थिर पोस्ट से परे बढ़ता है, तो वही API रील और हाइलाइट कहानियों को कवर करता है।

रील विवरण प्राप्त करें

• विधि: GET
• अनुरोध URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
• आवश्यक क्वेरी पैरामीटर: idOrUrl (string), जैसे कि एक रील URL

यह रील का id, कोड, लेखक ब्लॉक, createdAt, शीर्षक, सांख्यिकी (लाइक/टिप्पणी की गिनती), और एक downloadUrl लौटाता है। createdAt को यूनिक्स युग (सेकंड) के रूप में संभालें और लेखक.username को श्रेय के लिए स्टोर करें।

हाइलाइट कहानी विवरण प्राप्त करें

• विधि: GET
• अनुरोध URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
• आवश्यक क्वेरी पैरामीटर: id (string), जो हाइलाइट ID है

जब आप पहले से एक हाइलाइट ID जानते हैं और सभी शामिल कहानियों की आवश्यकता होती है, तो इसका उपयोग करें। आपको हाइलाइट का शीर्षक, totalStories, और प्रत्येक कहानी के लिए mediaType, createdAt, thumbnailUrl, और downloadUrl के साथ कहानियों का एक एरे प्राप्त होगा।

आधिकारिक हब लिस्टिंग उदाहरण (प्रोफ़ाइल विवरण)

API एक प्रोफ़ाइल लुकअप भी उजागर करता है। संदर्भ के लिए नीचे Zyla Hub लिस्टिंग से आधिकारिक उदाहरण है।

यदि आप समय के साथ मैट्रिक्स को प्रवृत्त करने की योजना बनाते हैं तो followerCount/totalPosts स्नैपशॉट स्टोर करें। isPrivateAccount उस उपयोगकर्ता के लिए डाउनस्ट्रीम मीडिया एंडपॉइंट्स द्वारा लौटाए जाने वाले डेटा को सीमित कर सकता है।

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

• प्रमाणीकरण: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
• टाइमस्टैम्प: createdAt फ़ील्ड यूनिक्स युग सेकंड हैं। UTC का उपयोग करके परिवर्तित करें, फिर यदि आवश्यक हो तो उपयोगकर्ता के समय क्षेत्र में प्रारूपित करें।
• मीडिया डाउनलोड: downloadUrl और thumbnailUrl CDN संसाधनों की ओर इशारा करते हैं। ये लिंक समाप्त हो सकते हैं; यदि आपको दीर्घकालिकता की आवश्यकता है, तो सामग्री को डाउनलोड करें और अपने स्वयं के संग्रहण में स्टोर करें, स्रोत शर्तों का सम्मान करते हुए।
• त्रुटि हैंडलिंग: खाली डेटा या अनुपस्थित फ़ील्ड को गैर-घातक के रूप में मानें; सामाजिक सामग्री को हटा दिया जा सकता है या प्रतिबंधित किया जा सकता है।
• अनुरोध मात्रा: हब सब्सक्रिप्शन + कोटा (प्रति कॉल भुगतान नहीं) का उपयोग करता है। पहले एक्सेस विकल्प 7-दिन का परीक्षण या उपलब्ध होने पर 50 अनुरोध हैं। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

AI एजेंटों से MCP के माध्यम से इन एंडपॉइंट्स को कॉल करें

यदि आप AI कोडिंग उपकरणों (Claude Code, Cursor, Windsurf या कोई भी MCP-संगत क्लाइंट) के माध्यम से स्वचालित करते हैं, तो आप अनुरोधों को Zyla के MCP एंडपॉइंट के माध्यम से रूट कर सकते हैं:

• एजेंटों के लिए एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
• उपकरण दस्तावेज़: MCP

अपने एजेंट में एक उपकरण उजागर करें जो ऊपर दस्तावेज़ित हब URLs को कॉल करता है, प्राधिकरण हेडर पास करता है, और समान JSON संरचनाओं को पार्स करता है। पहले मीडिया सूची आइटम को चुनने जैसे व्यावसायिक तर्क को आपके एजेंट के उपकरण कोड में रखें ताकि मॉडल टोकन को न्यूनतम किया जा सके।

इस सप्ताह आप जो अंत-से-अंत उदाहरण भेज सकते हैं

• CMS में एक पोस्ट को स्वचालित रूप से एम्बेड करें: idOrUrl को शीर्षक, author.username, statistics.likeCount, और mediaList[0].downloadUrl में हल करें; 24 घंटे के लिए कैश करें; प्रकाशित करने पर फिर से मान्य करें।
• साप्ताहिक सगाई स्नैपशॉट: समय-समय पर उन पोस्टों को प्राप्त करें जो आपको महत्वपूर्ण हैं और trend चार्ट के लिए statistics.likeCount/commentCount और createdAt रिकॉर्ड करें।
• रील फीचर रेल: URL द्वारा get-reel-details प्राप्त करें, author.profilePictureUrl, शीर्षक, और downloadUrl से बंधा एक प्ले बटन प्रदर्शित करें।
• हाइलाइट गैलरी: एक ज्ञात हाइलाइट id के लिए, stories[].thumbnailUrl को ग्रिड में सूचीबद्ध करें; क्लिक करने पर, stories[].downloadUrl को स्ट्रीम करें।

संदर्भ: वास्तविक एंडपॉइंट्स और पैरामीटर

• पोस्ट विवरण प्राप्त करें (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
  • आवश्यक पैरामीटर: idOrUrl (string), जैसे कि https://www.instagram.com/p/DfALy1PTBSa/
• रील विवरण प्राप्त करें (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
  • आवश्यक पैरामीटर: idOrUrl (string), जैसे कि https://www.instagram.com/reel/DctYV2qt6S5/
• हाइलाइट कहानी विवरण प्राप्त करें (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
  • आवश्यक पैरामीटर: id (string), जैसे कि 17910014403011985
• प्रोफ़ाइल विवरण प्राप्त करें (GET, लिस्टिंग उदाहरण): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
  • आवश्यक पैरामीटर: username (string)

Zyla API Hub पर अधिक श्रेणियों का अन्वेषण करें; मार्केटप्लेस एक ही खाते और कुंजी के तहत 10,000 से अधिक सार्वजनिक APIs सूचीबद्ध करता है।

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

मैं प्रमाणीकरण कैसे करता हूँ?
हर अनुरोध पर एक HTTP हेडर भेजें: Authorization: Bearer YOUR_API_KEY।

createdAt का प्रारूप क्या है?
यूनिक्स युग सेकंड। UTC में datetime में परिवर्तित करें, फिर अपने पसंदीदा समय क्षेत्र में प्रारूपित करें।

क्या मीडिया URLs समाप्त होते हैं?
वे हो सकते हैं। यदि आपको स्थिर संपत्तियों की आवश्यकता है, तो downloadUrl प्राप्त करें और सामग्री को अपने स्वयं के संग्रहण में स्टोर करें, स्रोत शर्तों का सम्मान करते हुए।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। आप 7-दिन के परीक्षण या उपलब्ध होने पर 50 अनुरोधों के साथ शुरू कर सकते हैं; वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

क्या मैं इन एंडपॉइंट्स को AI एजेंट से कॉल कर सकता हूँ?
हाँ। https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर MCP गेटवे का उपयोग करें और एजेंट को प्राधिकरण हेडर के साथ वही हब URLs कॉल करने दें।

शिप करने के लिए तैयार? अपनी कुंजी प्राप्त करें और लिस्टिंग पृष्ठ से एंडपॉइंट्स को कॉल करना शुरू करें: Instagram प्रोफ़ाइल और मीडिया डेटा API पर 7-दिन का परीक्षण शुरू करें।