एपीआई के ज़रिए Instagram फ़ॉलोअर डेमोग्राफ़िक्स
Instagram के खाते का इनसाइट्स एंडपॉइंट metric=follower_demographics, period=lifetime, metric_type=total_value, एक टाइमफ़्रेम और उम्र, लिंग, शहर या देश का ब्रेकडाउन लेकर फ़ॉलोअर डेमोग्राफ़िक्स लौटाता है। engaged_audience_demographics वही काम उन खातों के लिए करता है जिन्होंने कंटेंट से इंटरैक्ट किया है। Meta केवल शीर्ष 45 वैल्यू लौटाता है; फ़ॉलोअर डेटा के लिए 100 फ़ॉलोअर चाहिए, और engaged डेटा के लिए टाइमफ़्रेम में 100 एंगेजमेंट।
easyCoexistence get_social_insights से Instagram के फ़ॉलोअर और engaged ऑडियंस के डेमोग्राफ़िक्स पढ़ता है, ताकि Claude, ChatGPT या आपका अपना कोड पूछ सके कि कौन-से देश, शहर या आयु वर्ग खाते को फ़ॉलो करते हैं, और कनेक्टेड खाते के लिए Meta के आँकड़े पाए।
इससे कम होने पर खाते के लिए follower_demographics नहीं लौटाया जाता।
टाइमफ़्रेम में ज़रूरी एंगेजमेंट पूरे होने के बाद ही engaged_audience_demographics लौटता है।
डेमोग्राफ़िक मेट्रिक्स केवल शीर्ष 45 परफ़ॉर्मर लौटाते हैं, इसलिए छोटे शहर और देश बाहर रह जाते हैं।
engaged_audience_demographics के लिए last_14_days, last_30_days, last_90_days और prev_month हर वर्शन में बंद हो गए।
खाते के मेट्रिक्स के पीछे का डेटा कितनी देर तक विलंबित हो सकता है।
कौन-से डेमोग्राफ़िक मेट्रिक्स हैं?
Meta के इनसाइट्स रेफ़रेंस में दो, जिन्हें GET /<IG_ID>/insights से पढ़ा जाता है, और दो पुराने सेट जो पुराना कोड अभी भी माँगता है:
follower_demographics: खाते के फ़ॉलोअर्स की डेमोग्राफ़िक विशेषताएँ।engaged_audience_demographics: यही बात एंगेज्ड ऑडियंस के लिए, यानी वे खाते जिन्होंने उसके कंटेंट से इंटरैक्ट किया।- दोनों: period lifetime,
metric_typetotal_value, एक टाइमफ़्रेम, और उम्र, शहर, देश या लिंग का ब्रेकडाउन। audience_gender_age,audience_locale,audience_countryऔरaudience_city: 11 दिसंबर 2023 को बंद कर दिए गए।reached_audience_demographics: Meta के 2024 के चेंजलॉग में नाम है, पर उसकी मौजूदा मेट्रिक्स तालिका में नहीं है।
फ़ॉलोअर डेमोग्राफ़िक्स कैसे माँगें?
मेट्रिक, period=lifetime, metric_type=total_value, एक टाइमफ़्रेम और एक ब्रेकडाउन के साथ। timeframe, since और until की जगह लेता है, जिन्हें डेमोग्राफ़िक मेट्रिक्स सपोर्ट नहीं करते, और यह ज़रूरी है। Instagram Login के साथ टोकन को instagram_business_basic और instagram_business_manage_insights चाहिए, और कॉल graph.instagram.com पर जाती है:
GET https://graph.instagram.com/<IG_ID>/insights
?metric=follower_demographics
&period=lifetime
&timeframe=this_month
&breakdown=country
&metric_type=total_value
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>जवाब कैसा दिखता है?
गिनती total_value.breakdowns में आती है। dimension_keys बताता है कि कौन-सा टाइमफ़्रेम और ब्रेकडाउन माँगा गया, और हर परिणाम में dimension_values, टाइमफ़्रेम और ब्रेकडाउन की एक वैल्यू, गिनती के साथ जुड़ी होती है। Meta का नमूना, देश के अनुसार engaged ऑडियंस के लिए, देशों को US और ES जैसे दो-अक्षरों के कोड में लौटाता है:
{
"data": [
{
"name": "follower_demographics",
"period": "lifetime",
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"total_value": {
"breakdowns": [
{
"dimension_keys": ["timeframe", "country"],
"results": [
{ "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> },
{ "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> }
]
}
]
},
"id": "<IG_ID>/insights/follower_demographics/lifetime"
}
]
}कौन-से टाइमफ़्रेम काम करते हैं?
Meta का रेफ़रेंस दोनों मेट्रिक्स के लिए last_14_days, last_30_days, last_90_days, prev_month, this_month और this_week सूचीबद्ध करता है, और engaged ऑडियंस के लिए this_month को पिछले 30 दिन और this_week को पिछले 7 दिन बताता है। engaged_audience_demographics के लिए पहले चार v20.0 से और 19 अगस्त 2024 को हर वर्शन में बंद हो गए, इसलिए this_week या this_month इस्तेमाल करें; वह चेंजलॉग एंट्री follower_demographics का नाम नहीं लेती।
कौन-सी सीमाएँ और लिमिट लागू होती हैं?
Meta का इनसाइट्स रेफ़रेंस डेमोग्राफ़िक मेट्रिक्स के लिए ये नियम तय करता है:
- 100 से कम फ़ॉलोअर वाले खाते के लिए
follower_demographicsनहीं लौटाया जाता। - टाइमफ़्रेम में 100 से कम एंगेजमेंट होने पर
engaged_audience_demographicsनहीं लौटाया जाता। - केवल शीर्ष 45 परफ़ॉर्मर लौटते हैं, इसलिए छोटे शहर और देश बाहर रह जाते हैं।
- केवल वे दर्शक गिने जाते हैं जिनका डेमोग्राफ़िक डेटा है, इसलिए वैल्यू का जोड़ फ़ॉलोअर संख्या से कम हो सकता है।
- डेटा गायब हो तो खाली सेट लौटता है, 0 नहीं, और डेटा 48 घंटे तक पीछे रह सकता है।
- जो ब्रेकडाउन माँगी गई मेट्रिक सपोर्ट नहीं करती, वह पूरी कॉल को An unknown error has occurred के साथ विफल कर देता है।
क्या Instagram Login के साथ डेमोग्राफ़िक्स काम करते हैं?
हाँ। Meta ने 21 जनवरी 2025 को खाते और मीडिया इनसाइट्स को Instagram Login ऐप्स के लिए खोला, और उसका इनसाइट्स रेफ़रेंस Instagram Login को instagram_business_basic और instagram_business_manage_insights अनुमतियों और graph.instagram.com होस्ट के साथ सूचीबद्ध करता है। खाता बिज़नेस या क्रिएटर का होना चाहिए, जैसा Meta का Instagram Platform माँगता है।
get_social_insights डेमोग्राफ़िक्स कैसे पढ़ता है?
metrics को follower_demographics या engaged_audience_demographics, period को lifetime और params में timeframe, breakdown और metric_type के साथ सेट करके। easyCoexistence कनेक्टेड खाते के लिए उसके टोकन से GET /<IG_ID>/insights कॉल करता है और Meta का जवाब लौटाता है, ताकि Claude या ChatGPT बता सकें कि कौन-से देश, शहर या आयु वर्ग खाते को फ़ॉलो करते हैं।
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}आम गड़बड़ियाँ
- since और until भेजना। डेमोग्राफ़िक मेट्रिक्स इन्हें सपोर्ट नहीं करते: timeframe रेंज तय करता है, और वह ज़रूरी है।
- engaged ऑडियंस के लिए last_30_days या last_90_days इस्तेमाल करना। ये टाइमफ़्रेम 19 अगस्त 2024 को हर वर्शन में engaged_audience_demographics के लिए बंद हो गए।
- फ़ॉलोअर संख्या पाने के लिए ब्रेकडाउन का जोड़ निकालना। केवल डेमोग्राफ़िक डेटा वाले दर्शक गिने जाते हैं और केवल शीर्ष 45 वैल्यू लौटते हैं, इसलिए जोड़ कम पड़ता है।
- छोटे खाते से डेटा की उम्मीद करना। फ़ॉलोअर डेमोग्राफ़िक्स के लिए 100 फ़ॉलोअर चाहिए, और engaged ऑडियंस के लिए टाइमफ़्रेम में 100 एंगेजमेंट।
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे आप कनेक्शन जोड़ते हैं वैसे घटता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
Instagram खाते को डेमोग्राफ़िक्स के लिए कितने फ़ॉलोअर चाहिए?
100। उससे कम पर Meta follower_demographics नहीं लौटाता; engaged_audience_demographics के लिए टाइमफ़्रेम में 100 एंगेजमेंट चाहिए।
Instagram केवल 45 शहर क्यों लौटाता है?
Meta के डेमोग्राफ़िक मेट्रिक्स केवल शीर्ष 45 परफ़ॉर्मर लौटाते हैं, इसलिए छोटे शहर और देश छूट जाते हैं।
Instagram API में audience_gender_age की जगह क्या आया?
follower_demographics, उम्र, लिंग, शहर या देश के ब्रेकडाउन के साथ। Meta ने 11 दिसंबर 2023 को audience_gender_age, audience_locale, audience_country और audience_city बंद कर दिए।
क्या follower_demographics के साथ since और until इस्तेमाल कर सकते हैं?
नहीं। डेमोग्राफ़िक मेट्रिक्स since और until सपोर्ट नहीं करते; उनकी जगह timeframe पैरामीटर रेंज तय करता है, और वह ज़रूरी है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित