البيانات الديموغرافية لمتابعي Instagram عبر واجهة برمجة التطبيقات (API)
تُعيد نقطة النهاية (endpoint) الخاصة بإحصاءات الحساب بيانات متابعي الحساب الديموغرافية عند ضبط metric=follower_demographics وperiod=lifetime وmetric_type=total_value، مع timeframe وتفصيل حسب العمر أو الجنس أو المدينة أو الدولة. تفعل engaged_audience_demographics الشيء نفسه للحسابات التي تفاعلت مع المحتوى. تعيد Meta أعلى 45 قيمة فقط؛ تحتاج بيانات المتابعين إلى 100 متابع، وبيانات الجمهور المتفاعل إلى 100 تفاعل خلال الإطار الزمني.
يقرأ easyCoexistence الخصائص الديموغرافية لمتابعي Instagram والجمهور المتفاعل عبر get_social_insights، فيستطيع Claude أو ChatGPT أو كودك الخاص أن يسأل أي الدول أو المدن أو الفئات العمرية تتابع الحساب، ويحصل على أرقام Meta للحساب المتصل.
أقل من هذا العدد، لا تُعاد follower_demographics للحساب.
عدد التفاعلات المطلوب خلال الإطار الزمني قبل أن تُعاد engaged_audience_demographics.
تعيد المقاييس الديموغرافية أعلى 45 قيمة فقط، فتسقط المدن والدول الأصغر.
متى توقفت الأطر last_14_days وlast_30_days وlast_90_days وprev_month عن العمل مع engaged_audience_demographics في كل الإصدارات.
مدة التأخير المحتملة في البيانات التي تقوم عليها مقاييس الحساب.
ما المقاييس الديموغرافية المتاحة؟
مقياسان في مرجع إحصاءات الحساب لدى Meta، يُقرآن بالطلب GET /<IG_ID>/insights، ومجموعتان أقدم ما زال الكود القديم يطلبهما:
follower_demographics: الخصائص الديموغرافية لمتابعي الحساب.engaged_audience_demographics: الخصائص نفسها للجمهور المتفاعل، أي الحسابات التي تفاعلت مع محتواه.- الاثنان: period=lifetime و
metric_type=total_valueوtimeframe وتفصيل حسب العمر أو المدينة أو الدولة أو الجنس. audience_gender_ageوaudience_localeوaudience_countryوaudience_city: أُوقفت في 11 ديسمبر 2023.reached_audience_demographics: وردت في سجل تغييرات Meta لعام 2024 لكنها غائبة عن جدول المقاييس الحالي.
كيف تطلب الخصائص الديموغرافية للمتابعين؟
بالمقياس وperiod=lifetime وmetric_type=total_value وtimeframe وتفصيل واحد. يحل timeframe محل since وuntil اللذين لا تدعمهما المقاييس الديموغرافية، وهو إلزامي. مع Instagram Login يحتاج رمز الوصول (token) إلى الصلاحيتين 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 للجمهور المتفاعل حسب الدولة، تأتي الدول برموز من حرفين مثل 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 لكلا المقياسين، ويصف للجمهور المتفاعل أن this_month تعني آخر 30 يومًا وthis_week آخر 7 أيام. أما engaged_audience_demographics فقد توقفت الأربعة الأولى منذ الإصدار v20.0 وفي كل الإصدارات بتاريخ 19 أغسطس 2024، لذا استخدم this_week أو this_month. ولا يذكر ذلك الإدخال في سجل التغييرات follower_demographics.
ما الحدود والقيود المطبقة؟
تضع مقاييس Meta للحسابات القواعد التالية للمقاييس الديموغرافية:
- لا تُعاد
follower_demographicsلحساب لديه أقل من 100 متابع. - لا تُعاد
engaged_audience_demographicsمع أقل من 100 تفاعل خلال الإطار الزمني. - تُعاد أعلى 45 قيمة فقط، فتسقط المدن والدول الأصغر.
- تُحتسب المشاهدات التي لديها بيانات ديموغرافية فقط، لذلك قد يكون مجموع القيم أقل من عدد المتابعين.
- البيانات الناقصة تعيد مجموعة فارغة لا 0، وقد تتأخر البيانات حتى 48 ساعة.
- إذا لم يدعم المقياس المطلوب التفصيل المطلوب، يفشل الاستدعاء كله برسالة "An unknown error has occurred".
هل تعمل الخصائص الديموغرافية مع Instagram Login؟
نعم. فتحت Meta إحصاءات الحساب والوسائط لتطبيقات Instagram Login في 21 يناير 2025، ويدرج مرجع إحصاءات الحساب لديها Instagram Login مع الصلاحيتين instagram_business_basic وinstagram_business_manage_insights، ويجعل graph.instagram.com المضيف. يجب أن يكون الحساب حساب نشاط تجاري أو حساب منشئ، كما تشترط منصة Instagram لدى Meta.
كيف يقرأ 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 النطاق، وهو إلزامي.
- استخدام last_30_days أو last_90_days للجمهور المتفاعل. توقفت هذه الأطر عن العمل مع engaged_audience_demographics في كل الإصدارات بتاريخ 19 أغسطس 2024.
- جمع التفصيل للحصول على عدد المتابعين. تُحتسب المشاهدات التي لديها بيانات ديموغرافية فقط، ولا تُعاد إلا أعلى 45 قيمة، فيقصر المجموع عن الرقم الحقيقي.
- توقع بيانات من حساب صغير. تحتاج الخصائص الديموغرافية للمتابعين إلى 100 متابع، والجمهور المتفاعل إلى 100 تفاعل خلال الإطار الزمني.
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
كم عدد المتابعين الذي يحتاجه حساب Instagram للحصول على الخصائص الديموغرافية؟
100. دون ذلك لا تعيد Meta follower_demographics؛ وengaged_audience_demographics تحتاج إلى 100 تفاعل خلال الإطار الزمني.
لماذا تعيد Instagram 45 مدينة فقط؟
تعيد مقاييس Meta الديموغرافية أعلى 45 قيمة فقط، لذلك تُستبعد المدن والدول الأصغر.
ما الذي حل محل audience_gender_age في Instagram API؟
follower_demographics مع تفصيل حسب العمر أو الجنس أو المدينة أو الدولة. أوقفت Meta audience_gender_age وaudience_locale وaudience_country وaudience_city في 11 ديسمبر 2023.
هل يمكن استخدام since وuntil مع follower_demographics؟
لا. المقاييس الديموغرافية لا تدعم since وuntil؛ بل يحدد معامل timeframe النطاق، وهو إلزامي.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في