Instagram हैशटैग सर्च API: हैशटैग से पोस्ट ढूंढना
Instagram की हैशटैग सर्च दो कॉल में हैशटैग वाली सार्वजनिक फ़ोटो और वीडियो ढूंढती है। user_id और q के साथ GET /ig_hashtag_search हैशटैग का ID लौटाता है, फिर GET /<HASHTAG_ID>/top_media सबसे लोकप्रिय पोस्ट और /recent_media पिछले 24 घंटों में प्रकाशित पोस्ट सूचीबद्ध करता है। कोई खाता 7 दिनों की रोलिंग अवधि में 30 अलग हैशटैग क्वेरी कर सकता है, जिसके लिए Facebook Login या Unified Login ज़रूरी है।
easyCoexistence Instagram Login से Instagram को जोड़ता है, ताकि Claude, ChatGPT या आपका अपना कोड Meta के आधिकारिक API के ज़रिए खाते की अपनी पोस्ट, कमेंट, मेंशन और इनसाइट पर काम करे, और उसके कमेंट व मेंशन जैसे ही आते हैं, आपके एंडपॉइंट पर भेजे जा सकते हैं।
एक कारोबार या क्रिएटर खाता रोलिंग 7-दिन की अवधि में जितने अलग हैशटैग क्वेरी कर सकता है, उनकी सीमा तय है।
recent_media केवल वही मीडिया लौटाता है जो क्वेरी से 24 घंटे के भीतर प्रकाशित हुआ हो।
top_media से प्रति पेज सबसे अधिक परिणाम मिलते हैं, और यह केवल after कर्सर से पेज करता है।
Meta की तीन सेटअप की तुलना में Instagram Login के साथ Instagram API से हैशटैग सर्च।
हैशटैग ID स्टैटिक और ग्लोबल होते हैं: हर ऐप और यूज़र के लिए एक हैशटैग का ID एक जैसा रहता है।
हैशटैग सर्च कैसे काम करता है?
यह दो चरणों में होता है, और यह एक Instagram कारोबारी या क्रिएटर खाते की ओर से किया जाता है, जिसका ID user_id में जाता है। GET /ig_hashtag_search में q पर हैशटैग का नाम देने से उसका ID मिलता है, जो Meta के अनुसार स्टैटिक और ग्लोबल है, इसलिए उसे सहेजा जा सकता है। फिर user_id और fields के साथ GET /<HASHTAG_ID>/top_media या /recent_media पोस्ट सूचीबद्ध करता है।
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee
{ "data": [ { "id": "<HASHTAG_ID>" } ] }
GET /<HASHTAG_ID>/recent_media
?user_id=<IG_ID>
&fields=id,media_type,permalink,timestamp,like_count,comments_counttop_media और recent_media में क्या अंतर है?
top_media हैशटैग वाली सबसे लोकप्रिय फ़ोटो और वीडियो लौटाता है; लोकप्रियता को Meta व्यूज़ और दर्शकों के इंटरैक्शन के मिश्रण से आंकता है। recent_media सबसे हाल में प्रकाशित पोस्ट लौटाता है, जो क्वेरी से 24 घंटे के भीतर प्रकाशित मीडिया तक सीमित हैं, और Meta बताता है कि उसके परिणाम हमेशा कालक्रम में नहीं होते। दोनों केवल सार्वजनिक मीडिया लौटाते हैं, प्रमोटेड, बूस्टेड और विज्ञापन मीडिया छोड़ देते हैं, और after कर्सर के साथ 50-50 परिणामों के पेज में आगे बढ़ते हैं।
कौन से फ़ील्ड वापस आते हैं?
Meta की संदर्भ सूची में दोनों एज के लिए मीडिया फ़ील्ड, जो केवल सार्वजनिक फ़ोटो और वीडियो लौटाते हैं:
- id,
media_type(CAROUSEL_ALBUM, IMAGE या VIDEO), permalink और timestamp। - caption और
comments_count, साथ हीlike_count, जब तक पोस्ट का मालिक लाइक काउंट छिपाए न हो। - एल्बम मीडिया के लिए children, और अन्य मीडिया के लिए
media_url, लेकिन कॉपीराइट या लाइसेंस वाले ऑडियो वाले वीडियो के लिए नहीं। - username नहीं: Meta हैशटैग सर्च से मिले मीडिया पर इसकी अनुमति नहीं देता।
सीमाएँ क्या हैं?
Meta इन्हें खाते और हैशटैग, दोनों के हिसाब से तय करता है:
- 7 दिनों की रोलिंग अवधि में 30 अलग हैशटैग। गिनती पहली क्वेरी से शुरू होती है; उस अवधि में उसे दोबारा क्वेरी करने से कोटा खर्च नहीं होता और उसके 7 दिन फिर से शुरू नहीं होते।
top_mediaयाrecent_mediaलाना हैशटैग की क्वेरी माना जाता है, भले ही उसका ID पहले से सहेजा हो।- GET /<
IG_ID>/recently_searched_hashtagsउस हफ़्ते में खाते द्वारा खोजे गए अलग हैशटैग की सूची देता है। - Stories पर हैशटैग और क्वेरी में इमोजी समर्थित नहीं हैं, और Meta जिन हैशटैग को संवेदनशील या आपत्तिजनक मानता है, वे एक सामान्य गड़बड़ी लौटाते हैं।
- इस तरीके से मिले मीडिया पर API के ज़रिए कमेंट नहीं किया जा सकता।
हैशटैग सर्च के लिए क्या चाहिए?
Instagram Public Content Access फ़ीचर और instagram_basic अनुमति के लिए App Review की मंज़ूरी, जो Meta ऐप के उपयोग से पहले ज़रूरी मानता है, और Facebook Login से यूज़र ऐक्सेस टोकन, उस व्यक्ति के लिए जो जुड़े पेज पर कार्य कर सके, या Unified Login टोकन। Meta के ओवरव्यू में हैशटैग सर्च Instagram Login के साथ समर्थित नहीं दिखाया गया है, और इसकी कॉल Instagram के प्रति-खाता कॉल बजट के बजाय Meta प्लेटफ़ॉर्म की रेट लिमिट के अंतर्गत आती हैं। Meta द्वारा सूचीबद्ध अनुमत उपयोगों में आपके हैशटैग अभियानों की सामग्री खोजना, ब्रांड के बारे में सार्वजनिक भावना समझना और प्रतियोगिता के प्रतिभागियों की पहचान करना शामिल हैं।
क्या easyCoexistence के ज़रिए हैशटैग सर्च कर सकते हैं?
easyCoexistence Instagram Login से Instagram को जोड़ता है, जो जुड़े खाते की अपनी पोस्ट, कमेंट, मेंशन और इनसाइट तक पहुँचता है। Meta हैशटैग सर्च केवल Facebook Login और Unified Login के साथ देता है, इसलिए वह इस कनेक्शन के दायरे से बाहर है। कनेक्शन इसके बजाय यह कवर करता है: खाते की अपनी पोस्ट list_social_posts के ज़रिए, और उसके कमेंट व मेंशन, जैसे ही आते हैं, आपके एंडपॉइंट पर भेजे जाते हैं।
आम गड़बड़ियाँ
- साप्ताहिक कोटा जाँच में खर्च करना। हर नया हैशटैग 7 दिनों के 30 में गिना जाता है, और उसका मीडिया लाना, सहेजे ID के साथ भी, गिना जाता है।
- हैशटैग परिणामों पर username माँगना। Meta इसे हैशटैग सर्च से मिले मीडिया के लिए नहीं लौटाता।
- recent_media को आर्काइव समझना। यह क्वेरी से पहले के 24 घंटों में प्रकाशित मीडिया को कवर करता है, और सख़्त कालानुक्रम में नहीं।
- Instagram Login टोकन से कॉल करना। Meta उस सेटअप में हैशटैग सर्च को समर्थित नहीं मानता।
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75, कनेक्शन बढ़ने के साथ घटती कीमत, पहले 3 दिन निःशुल्क।
अक्सर पूछे जाने वाले सवाल
क्या Instagram API App Review के बिना हैशटैग सर्च कर सकता है?
नहीं। हैशटैग सर्च कॉल करने से पहले Meta को Instagram Public Content Access फ़ीचर और instagram_basic के लिए App Review की मंज़ूरी चाहिए।
क्या मैं देख सकता हूँ कि हैशटैग के साथ किसने पोस्ट किया?
username से नहीं, क्योंकि Meta उसे हैशटैग परिणामों में शामिल नहीं करता। हर पोस्ट का permalink उसे Instagram पर खोलता है।
क्या हैशटैग सर्च में Stories शामिल हैं?
नहीं। Meta Stories पर हैशटैग को समर्थित नहीं करता, और दोनों एज केवल सार्वजनिक फ़ोटो और वीडियो लौटाते हैं।
क्या उसी हैशटैग को दोबारा क्वेरी करने पर दो बार गिना जाता है?
नहीं। उसके 7 दिनों के भीतर दोहराई गई क्वेरी 30 की सीमा में नहीं गिनी जातीं और हैशटैग का टाइमर दोबारा शुरू नहीं करतीं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित