मुख्य सामग्री पर जाएं
यदि आपको Instagram कनेक्ट करने में समस्या है, तो कृपया समस्या निवारण गाइड देखें।
यदि आपकी मीडिया एक server या CDN पर hosted है जिसे आप नियंत्रित करते हैं, तो सुनिश्चित करें कि Meta का प्रकाशन crawler इसे fetch कर सकता है। यदि आप Ayrshare error code 440 (“social network could not download media from this URL”) या विवरण में “Restricted by robots.txt” के साथ error code 138 देखते हैं तो Meta Media Crawler Blocked देखें।
Instagram API की निम्नलिखित आवश्यकताएँ और प्रतिबंध हैं।
  • Facebook Page के साथ कनेक्टेड Business या Creator Instagram खाता - यहाँ देखें
  • 24 घंटे की अवधि में केवल 50 Instagram posts की अनुमति है। usedQuota के लिए नीचे देखें
  • post text में 5 hashtags तक (जैसे #wildtimes) और 3 username mentions (जैसे @natgeo) हो सकते हैं।
  • @mention किए गए Instagram users को notification प्राप्त होगा।
  • अधिकतम 2,200 पोस्ट अक्षर।
  • Multi-image/video posts समर्थित हैं और carousel के रूप में भेजे जाते हैं। आप 10 videos और छवियाँ तक भेज सकते हैं।
  • Instagram API के माध्यम से deletes का समर्थन नहीं करता। Deletes को Instagram app का उपयोग करके मैन्युअल रूप से करना होगा।
  • यदि आपका Reel video mp4 जैसे ज्ञात video extension में समाप्त नहीं होता है, तो कृपया isVideo parameter का उपयोग करें। विवरण के लिए /post endpoint देखें।
  • Instagram पोस्ट text के बिना media भेजने का भी समर्थन करता है। यदि आप पोस्ट text शामिल नहीं करना चाहते हैं तो एक खाली String post: "" भेजें।
  • अधिक जानकारी के लिए Instagram Media Guidelines और Instagram Authorization देखें।

Instagram पर पोस्ट करना

Instagram पर एक छवि और hashtags के साथ एक बुनियादी पोस्ट के लिए JSON:
Instagram Post
Hashtags Instagram posts में clickable हैं, लेकिन links नहीं।
Instagram पर सफलतापूर्वक पोस्ट करने के लिए छवियों और videos का aspect ratio और वीडियो की अवधि बहुत महत्वपूर्ण हैं। यदि वे आवश्यकताओं को पूरा नहीं करते हैं, तो पोस्ट अस्वीकार कर दी जाएगी।कृपया छवि और वीडियो दिशानिर्देश का Instagram अनुभाग देखें

Instagram Business या Creator खाता

आपका Instagram खाता एक Business या Creator खाता होना चाहिए और एक Facebook Page के साथ कनेक्टेड होना चाहिए। सेटअप निःशुल्क और आसान है। विस्तृत निर्देशों के लिए यहाँ देखें:

Instagram Linking

आप Instagram पर एकाधिक छवियों या Reel videos को carousel के रूप में पोस्ट कर सकते हैं; carousel में 10 छवियों या videos के संयुक्त कुल तक का उपयोग किया जा सकता है। बस अपनी अतिरिक्त छवियों या videos को mediaUrls array में जोड़ें, और carousel स्वचालित रूप से बन जाएगा।
Instagram Carousel Post
Video URLs mp4 जैसे ज्ञात extension में समाप्त होने चाहिए। Instagram carousels के लिए isVideo parameter समर्थित नहीं है।

Instagram Reels

Instagram में एक video post को Reel कहा जाता है। आप निम्नलिखित वैकल्पिक instagramOptions विकल्पों के साथ Instagram Reels API पर एक वीडियो पोस्ट कर सकते हैं।
Instagram Reels Options
  • वीडियो आवश्यकताओं पर विवरण के लिए कृपया Reels API वीडियो आवश्यकताएँ देखें।
  • shareReelsFeed: Boolean जो true पर सेट है यह इंगित करने के लिए कि Reel दोनों Feed और Reels tabs में दिखाई दे सकता है या false यह इंगित करने के लिए कि Reel केवल Reels tab में दिखाई दे सकता है। यह मान Instagram को एक hint है कि आप Reel को कहाँ दिखाना चाहेंगे, लेकिन कोई भी मान यह निर्धारित नहीं करता कि Reel वास्तव में Reels या Feed tab में दिखाई देता है क्योंकि Reel eligibility आवश्यकताओं को पूरा नहीं कर सकता है या Instagram के algorithm द्वारा चुना नहीं जा सकता है।
  • audioName: आपके Reels media के audio music का String नाम। आप केवल एक बार rename कर सकते हैं, या तो एक reel बनाते समय या बाद में audio पेज से। उदाहरण के लिए, "The Weeknd - Blinding Lights"
  • thumbNail: Reel cover छवि (thumbnail) का String URL। thumbNail पर विवरण के लिए कृपया यहाँ देखें।
  • thumbNailOffset: thumbnail frame के मिलीसेकंड में Integer offset। कृपया यहाँ thumbNailOffset पर विवरण देखें।
कृपया Reels API वीडियो आवश्यकताएँ या Instagram Reels API का उपयोग करने का एक उदाहरण देखें। आप एक Reels cover url और location & user tags भी सेट कर सकते हैं।

Trial Reels

एक trial reel एक Reel है जो पहली बार पोस्ट होने पर केवल गैर-followers को प्रकाशित होती है, जिससे आप यह परीक्षण कर सकते हैं कि Reel आपके मौजूदा followers तक पहुँचने से पहले एक fresh audience के साथ कैसा प्रदर्शन करती है। एक Reel को trial के रूप में प्रकाशित करने के लिए instagramOptions में trialParams.graduationStrategy सेट करें।
Instagram Trial Reel
graduationStrategy नियंत्रित करता है कि कोई trial reel बाद में कैसे “graduate” होगा — यानी आपके followers के लिए भी दृश्यमान हो जाता है। जब trialParams प्रदान किया जाता है तो यह आवश्यक होता है और इनमें से एक होना चाहिए:
  • “MANUAL” — पोस्ट तब तक trial reel रहता है जब तक आप Instagram app के भीतर से इसे मैन्युअल रूप से graduate नहीं करते।
  • “SS_PERFORMANCE” — Meta गैर-followers के विरुद्ध प्रारंभिक performance के आधार पर Reel को स्वचालित रूप से graduate करता है।
Graduation स्वयं (एक प्रकाशित trial reel को followers तक promote करना) वर्तमान में Meta के API द्वारा उजागर नहीं है और इसे Instagram app में मैन्युअल रूप से करना होगा। जब Meta एक graduation endpoint उजागर करेगा, तो Ayrshare एक जोड़ेगा।

Trial reel प्रतिबंध

Trial reel अनुरोध Ayrshare edge पर अस्वीकृत होता है — किसी भी Meta कॉल से पहले — जब इनमें से कोई भी शर्त पूरी नहीं होती:
  • ठीक एक media URL जो .mp4 या .mov (case-insensitive) में समाप्त होता है। Carousels समर्थित नहीं हैं।
  • instagramOptions.stories true नहीं होना चाहिए। Stories trial reels नहीं हो सकतीं।
  • graduationStrategy मौजूद होना चाहिए और ठीक “MANUAL” या “SS_PERFORMANCE” (case-sensitive) होना चाहिए।
विफलताएँ तीन Ayrshare error codes में से एक लौटाती हैं — पूर्ण payloads के लिए Instagram Trial Reel Errors (447, 448, 449) देखें।

Instagram Stories

आप निम्नलिखित instagramOptions के साथ एक एकल छवि या वीडियो को Instagram Story के रूप में पोस्ट कर सकते हैं। Instagram stories 24 घंटे के बाद गायब हो जाती हैं।
Stories Post
कृपया Stories API आवश्यकताएँ देखें।
  • Instagram Stories पोस्ट text का समर्थन नहीं करतीं - post फ़ील्ड में प्रदान किया गया कोई भी text, mentions सहित, अनदेखा किया जाएगा।
  • Stories 24 घंटे बाद समाप्त हो जाती हैं।
  • Instagram वर्तमान में केवल Instagram Business Accounts पर Story publishing का समर्थन करता है और Creator Accounts पर नहीं।
  • Instagram Stories collaborators का समर्थन नहीं करतीं।
  • Stickers (यानी, link, poll, location) प्रकाशित करना Instagram द्वारा समर्थित नहीं है।

Reels Thumbnails

आप Reel के एक frame को thumbnail छवि के रूप में या किसी बाहरी URL से अपनी खुद की cover छवि (thumbnail) चुन सकते हैं।
Instagram Thumbnail
Offset video Reel के thumbnail frame का मिलीसेकंड में स्थान है। Default मान 0 है, जो Reel का पहला frame है। यदि आप thumbnail URL और thumbnail offset दोनों निर्दिष्ट करते हैं, तो thumbnail offset अनदेखा किया जाएगा। Reel thumbnail को Reels thumbnail आवश्यकताओं का पालन करना चाहिए। Redirects के साथ Signed URLs cover URLs के साथ संगत होने की गारंटी नहीं है। हम एक non-signed URL या /media endpoint का उपयोग करने की अनुशंसा करते हैं।

वैकल्पिक Text

एक छवि में Instagram वैकल्पिक text, जिसे alt text भी कहा जाता है, जोड़ें। Instagram alt text अतिरिक्त user जानकारी और screen readers के लिए उपयोग की जाने वाली एक accessibility feature है।
  • Alt text प्रति छवि 1,000 अक्षरों तक का समर्थन करता है।
  • Instagram Reels या Stories के लिए alt text का समर्थन नहीं करता।
instagramOptions object में altText का उपयोग करें।
Instagram Alt Text
प्रत्येक alt text mediaUrls array में एक छवि या वीडियो के अनुरूप होना चाहिए। Alt text प्रत्येक छवि पर क्रम से लागू होगा।

User Tags और Locations

जब आप एक पोस्ट में उनके username का उपयोग करते हैं तो Instagram user को notification मिलेगी। कृपया सावधान रहें कि users को spam न करें या उनके username के साथ बार-बार पोस्ट न करें। यदि आप ऐसा करते हैं, तो Instagram आपके खाते को निलंबित या निष्क्रिय कर सकता है।
एक छवि या एक Reel को instagramOptions parameter का उपयोग करके Instagram users के साथ tag किया जा सकता है और एक छवि, वीडियो, या Reel को एक location के साथ tag किया जा सकता है।

Location

एक location locationId द्वारा निर्दिष्ट होती है, जो एक Facebook Page ID या Facebook Page नाम है। उदाहरण के लिए, Guggenheim Museum की Facebook page Id 7640348500 है या Facebook page नाम "@guggenheimmuseum"। Pages को एक भौतिक स्थान से जोड़ा जाना चाहिए।
Instagram Location
आप brand endpoint के साथ locationId (Page Id) लुक अप कर सकते हैं। कृपया ध्यान दें कि Page में एक location सूचीबद्ध होना चाहिए अन्यथा locationId एक error लौटाएगा।
Carousels में छवियों या videos पर समर्थित नहीं।

User Tags

Instagram tags आपको अपनी पोस्ट में अन्य Instagram users को tag करने की अनुमति देते हैं। Users को userTags द्वारा निर्दिष्ट किया जाता है जिसमें Instagram username और x/y निर्देशांक (केवल छवि) वाले objects का एक Array होता है। User tags एकल छवियों या Reels के लिए जोड़े जा सकते हैं, लेकिन नियमित videos, एकाधिक छवियों, या Stories के लिए नहीं।
  • Usernames सार्वजनिक Instagram खाते होने चाहिए। User handle का @ शामिल न करें।
  • x और y मान float संख्याएँ होनी चाहिए जो छवि के top-left से उत्पन्न हों, जिनकी 0.01.0 की सीमा हो। एकल छवियाँ। Reels के साथ शामिल न करें अन्यथा एक error होगा।
Instagram User Tags

Instagram Mentions

पोस्ट text में @handle जोड़कर किसी अन्य Instagram handle का उल्लेख करें। उदाहरण के लिए आप पोस्ट text में @ayrshare handle का उल्लेख कर सकते हैं:
Instagram Mentions
@mentioned user को उल्लेख की सूचना दी जाएगी। कृपया mentions पर महत्वपूर्ण नियमों की समीक्षा करें।

Collaboration

Instagram collaboration आपको दूसरों को collaborators के रूप में tag करके अन्य Instagram खातों के साथ सामग्री का सह-लेखन करने की अनुमति देता है। यह आपको अपनी पोस्ट पर creators के रूप में अन्य Instagram users को नामित करने की अनुमति देता है। जब tag किया जाता है, तो ये users मोबाइल app में collaborate करने के लिए एक निमंत्रण प्राप्त करते हैं। यदि वे स्वीकार करते हैं, तो पोस्ट उनकी feed में भी दिखाई देगी और उनके followers को दिखाई देगी, पोस्ट की reach और engagement क्षमता को बढ़ाएगी।

Collaborators

सार्वजनिक मूल लेखक किसी अन्य सार्वजनिक खाते को Instagram collaborator के रूप में tag कर सकता है। अन्य खाते को एक संदेश प्राप्त होगा, जो उन्हें अनुरोध को स्वीकार या अस्वीकार करने की अनुमति देता है। यदि दूसरा खाता स्वीकार करता है, तो पोस्ट उनकी profile पर भी दिखाई देगी और Instagram feed में उनके followers को वितरित की जाएगी। पोस्ट का header सामग्री को दोनों खातों को श्रेय देगा। आप एक Reel, छवि, या carousel में collaborators जोड़ सकते हैं। Instagram API के माध्यम से एक निजी collaborator को tag करने की अनुमति नहीं है। जबकि Instagram app के भीतर ऐसी कार्यक्षमता मौजूद है, प्लेटफ़ॉर्म और उनके APIs अक्सर feature parity पर नहीं होते।
Instagram Stories collaborators का समर्थन नहीं करतीं।
  • केवल उन collaborators को आमंत्रित करें जिनसे आप अपना निमंत्रण accept करने की उम्मीद करते हैं
  • यदि collaborator एक declined collaboration अनुरोध के साथ प्रतिक्रिया करता है, तो उन्हें फिर से आमंत्रित न करें जब तक कि आप decline के कारण को समझने के लिए उनसे संपर्क नहीं करते।
  • एक ही या एकाधिक users से बार-बार declines आपके Instagram और Ayrshare खाते को रद्द करने के जोखिम में डाल देंगे।
  • मूल लेखक किसी भी समय एक collaborator को जोड़ या हटा सकता है।
सार्वजनिक Instagram usernames के एक array के साथ तीन तक collaborators को आमंत्रित करें।
Instagram Collaborators
ये तीन collaborators अपने Instagram मोबाइल app में एक संदेश निमंत्रण प्राप्त करेंगे और invite को स्वीकार या अस्वीकार कर सकते हैं, और फिर आप आमंत्रित user अनुरोध स्थिति की जाँच कर सकते हैं। कृपया केवल उस collaborator को आमंत्रित करें जिसे आप जानते हैं कि आपके अनुरोध को स्वीकार करेगा अन्यथा आपके Instagram खाते पर नकारात्मक प्रभाव पड़ सकता है।
आमंत्रित collaborators के बारे में नोट: कुछ अपवादों के साथ, सह-लेखित media पर या उसके बारे में डेटा केवल उस user द्वारा API के माध्यम से एक्सेस किया जा सकता है जिसने media प्रकाशित किया था; collaborators API के माध्यम से इस डेटा तक पहुँचने में असमर्थ हैं।

Collaborator Request Status प्राप्त करें

एक Instagram collaborator को आमंत्रित करने के बाद, आप Get Collaborator Request Status API का उपयोग करके अनुरोध की स्थिति की जाँच कर सकते हैं।

Auto Image Resize

Max Pack आवश्यक
छवियों को autoResize parameter के साथ Instagram के साथ काम करने के लिए स्वचालित रूप से 1080 x 1080 px पर resize किया जाता है। कृपया ध्यान दें, यह सभी शामिल प्लेटफ़ॉर्म के लिए छवि को resize करेगा, इसलिए हम Instagram के लिए एक कॉल और अतिरिक्त प्लेटफ़ॉर्म के लिए एक अलग /post कॉल करने की अनुशंसा करते हैं।
Instagram Auto Image Resize

उपयोग किया गया Quota

Instagram प्रतिक्रिया में rolling 24 घंटे की अवधि में किए गए Instagram posts की संख्या के लिए वर्तमान usedQuota शामिल होगा। 24-rolling-hour अवधि में Instagram द्वारा केवल 50 Instagram posts की अनुमति है।
Instagram Used Quota
यदि quota पहुँच गया है, तो एक error संदेश लौटाया जाएगा।

Content Issues

Ayrshare में built-in media सुरक्षा शामिल है जो posting के दौरान कुछ media delivery समस्याओं का पता लगा सकती है और हल कर सकती है। जब कोई पोस्ट सफल होता है लेकिन एक content issue का पता चला और हल हुआ, तो प्रतिक्रिया में एक वैकल्पिक contentIssues object शामिल होता है। यह आपको अपनी media hosting के साथ समस्याओं को सक्रिय रूप से पहचानने और ठीक करने की अनुमति देता है। contentIssues object केवल तभी मौजूद होता है जब कोई issue पाया गया और हल किया गया — सामान्य सफल posts में इसे शामिल नहीं किया जाता।
Content Issues Response Example
यदि आप अपनी प्रतिक्रियाओं में originMediaHostFailed देखते हैं, तो आपकी media hosting में कोई समस्या हो सकती है जो social networks को आपकी media तक पहुँचने से रोकती है। विस्तृत समस्या निवारण चरणों के लिए Meta Media Crawler Blocked देखें।

Error विवरण

जब एक Instagram media publish विफल होता है, तो error object अब Ayrshare code और message के साथ, details फ़ील्ड में Meta के अंतर्निहित error text को उजागर करता है। यह आपको विभिन्न मूल कारणों (उदाहरण के लिए, एक aspect-ratio अस्वीकृति बनाम एक media-download विफलता) के बीच बिना support से संपर्क किए अंतर करने देता है।
Instagram Publish Error
message Ayrshare का स्थिर, मानव-पठनीय सारांश है, जबकि details विफल publish के लिए Meta द्वारा लौटाए गए raw text को echo करता है।

Instagram पोस्ट में line breaks या rich text जोड़ना

Instagram line breaks को एक विशेष नए line character के साथ एक पोस्ट में जोड़ा जा सकता है। Rich text, जैसे bold या italic अक्षर, कुछ html elements के साथ Instagram पोस्ट में जोड़ा जा सकता है।

अक्षर सीमाएँ

अधिक जानकारी के लिए कृपया Instagram Character Limits देखें।

अतिरिक्त endpoints

Collaborator Request Status प्राप्त करें