Skip to main content
GET
Comment API का उपयोग करके Ayrshare Post ID, Social Post ID, Ayrshare Comment ID, या Social Comment ID के साथ पोस्ट के लिए टिप्पणियाँ प्राप्त करें। विभिन्न ID प्रकारों के बारे में अधिक जानकारी के लिए कृपया Comments Overview देखें।
यदि Ayrshare Post ID का उपयोग कर रहे हैं तो किसी query parameters की आवश्यकता नहीं है।

अतिरिक्त टिप्पणी विवरण

  • X को छोड़कर सभी प्लेटफ़ॉर्म्स के लिए comment डेटा हर 10 मिनट में अद्यतन किया जाता है। X API द्वारा लगाए गए प्रतिबंधों के कारण, X के लिए comment डेटा को exponential backoff strategy का उपयोग करके ताज़ा किया जाता है, जिसका अर्थ है कि अद्यतन के बीच के अंतराल समय के साथ धीरे-धीरे बढ़ते हैं।
  • Facebook response में, replies पर की गई comment replies का हमेशा एक ही parent.id होता है।
  • टिप्पणियों के लिए LinkedIn replies प्राप्त करने के लिए "commentId": true और "searchPlatformId": true query parameters सेट करें और path parameter में Social Comment ID प्रदान करें।
  • Facebook और Instagram किसी पोस्ट पर सबसे नवीनतम 1,000 टिप्पणियाँ तक लौटाते हैं। Enterprise plan पर उच्च सीमाओं के संबंध में कृपया हमसे संपर्क करें।
  • अभी भी प्रोसेस किए जा रहे TikTok पोस्ट के लिए (जिसकी id "pending" है), get-comments एक स्पष्ट “still processing” त्रुटि लौटाता है (code: 288, HTTP 400), न कि एक सामान्य विफलता। tikTokPublished webhook fire होने के बाद या /history resolved video id दिखाने के बाद फिर से प्रयास करें।

मल्टीप्लेटफ़ॉर्म रीड्स और आंशिक सफलता

जब आप Ayrshare Post ID के साथ comments का अनुरोध करते हैं, तो पोस्ट कई प्लेटफ़ॉर्म पर फैल सकती है। Ayrshare प्रति प्लेटफ़ॉर्म एक अनुरोध (“leg”) फैन-आउट करता है और आंशिक सफलता लौटाता है यदि कुछ legs सफल होती हैं और अन्य विफल — स्वस्थ प्लेटफ़ॉर्म के comment डेटा हमेशा लौटाए जाते हैं, और प्रत्येक विफल leg शीर्ष-स्तरीय errors[] सरणी में सूचीबद्ध की जाती है।
  • कुछ प्लेटफ़ॉर्म सफल, कुछ विफल: प्रतिक्रिया HTTP 200 के साथ status: “partial” होती है। स्वस्थ प्लेटफ़ॉर्म ब्लॉक हमेशा की तरह लौटाए जाते हैं, और एक शीर्ष-स्तरीय errors[] सरणी प्रत्येक विफल leg को उसके platform, status, code, message, और id के साथ सूचीबद्ध करती है।
  • हर प्लेटफ़ॉर्म विफल: प्रतिक्रिया में status: “error” और पूर्ण errors[] सरणी होती है। HTTP स्टेटस प्रतिनिधि शीर्ष-स्तरीय त्रुटि कोड से मैप किया जाता है। कोड 485 HTTP 404 पर मैप होता है; अन्य प्रतिनिधि कोड अपनी स्वयं की मैपिंग का उपयोग करते हैं।
  • सभी प्लेटफ़ॉर्म सफल: प्रतिक्रिया अपरिवर्तित है — HTTP 200, status: “success”, और कोई errors[] कुंजी नहीं।
व्यवहार परिवर्तन — errors[] का निरीक्षण करें, HTTP स्टेटस पर शाखा न करें। क्योंकि एक विफल leg वाला मल्टीप्लेटफ़ॉर्म रीड अब पूरी प्रतिक्रिया को त्रुटि पर संकुचित करने के बजाय HTTP 200 लौटाता है, इंटीग्रेटर्स को प्रति-प्लेटफ़ॉर्म विफलताओं का पता लगाने के लिए केवल HTTP स्टेटस कोड पर निर्भर रहने के बजाय हमेशा शीर्ष-स्तरीय errors[] सरणी की उपस्थिति की जाँच करनी चाहिए।

समाप्त हो चुके या अनुपलब्ध Instagram / Facebook Story Comments

एक Instagram या Facebook Story comments leg जो समाप्त हो चुकी है या अनुपलब्ध है — जिससे इसकी comments पुनर्प्राप्त नहीं की जा सकतीं — कोड 485 के साथ errors[] में सामने आती है। एक प्रतिनिधि Instagram संदेश है “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” यदि कोई अन्य प्लेटफ़ॉर्म सफल होता है, तो उसकी comments अभी भी लौटाई जाती हैं और समग्र प्रतिक्रिया HTTP 200 होती है। सभी-विफल प्रतिक्रिया के लिए, प्रतिनिधि कोड 485 HTTP 404 पर मैप होता है; अन्य प्रतिनिधि कोड अपनी स्वयं की मैपिंग का उपयोग करते हैं। सटीक संदेश पाठ के बजाय code (485) पर मिलान करें।

उदाहरण: आंशिक सफलता प्रतिक्रिया

200: आंशिक सफलता

Header Parameters

Path Parameters

string
आवश्यक

Query Parameters

boolean
डिफ़ॉल्ट:false
यदि Ayrshare के माध्यम से प्रकाशित पोस्ट पर टिप्पणियाँ प्राप्त कर रहे हैं और Ayrshare Post ID का उपयोग कर रहे हैं, तो इस field को शामिल न करें - यह डिफ़ॉल्ट रूप से false है। यदि सोशल नेटवर्क द्वारा जनरेट किए गए Social Post ID या Social Comment ID का उपयोग करके टिप्पणियाँ प्राप्त कर रहे हैं, तो true पर सेट करें।
boolean
डिफ़ॉल्ट:false
यदि सोशल नेटवर्क द्वारा जनरेट की गई Social Comment ID का उपयोग करके टिप्पणियाँ प्राप्त कर रहे हैं, तो true पर सेट करें।यदि Ayrshare Post ID या Social Post ID का उपयोग करके comment प्राप्त कर रहे हैं, तो इस field को शामिल न करें - यह डिफ़ॉल्ट रूप से false है।
यदि commentId query parameter का उपयोग कर रहे हैं, तो आपको searchPlatformId को भी true पर सेट करना होगा।
string
यदि searchPlatformId या commentId true है तो आवश्यक है।कब उपयोग करें:
  • यदि Social Post ID और "searchPlatformId": true field का उपयोग कर रहे हैं। समर्थित प्लेटफ़ॉर्म्स: bluesky, facebook, instagram, linkedin, threads, tiktok, twitter, youtube
  • यदि Social Comment ID और "searchPlatformId": true और "commentId": true fields का उपयोग कर रहे हैं। समर्थित प्लेटफ़ॉर्म्स: facebook, instagram, linkedin
  • यदि Ayrshare Post ID का उपयोग कर रहे हैं, तो इस field को शामिल न करें - मूल पोस्ट जहाँ प्रकाशित किया गया था उन सभी प्लेटफ़ॉर्म्स से टिप्पणियाँ लौटाई जाएँगी।

Comment GET अनुरोध उदाहरण