تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

البيانات الديموغرافية لمتابعي 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 للحساب المتصل.

100 followers

أقل من هذا العدد، لا تُعاد follower_demographics للحساب.

100 engagements

عدد التفاعلات المطلوب خلال الإطار الزمني قبل أن تُعاد engaged_audience_demographics.

Top 45

تعيد المقاييس الديموغرافية أعلى 45 قيمة فقط، فتسقط المدن والدول الأصغر.

19 Aug 2024

متى توقفت الأطر last_14_days وlast_30_days وlast_90_days وprev_month عن العمل مع engaged_audience_demographics في كل الإصدارات.

48 hours

مدة التأخير المحتملة في البيانات التي تقوم عليها مقاييس الحساب.

ما المقاييس الديموغرافية المتاحة؟

مقياسان في مرجع إحصاءات الحساب لدى 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:

Followers by country, this month
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:

The response shape, broken down by country
{
  "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 أن يقول أي الدول أو المدن أو الفئات العمرية تتابع الحساب.

get_social_insights arguments for followers by age
{
  "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 تفاعل خلال الإطار الزمني.
إنجاز ذلك باستخدام EasyCoexistence

من 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 النطاق، وهو إلزامي.

تابع القراءة

تحليلات Instagram عبر واجهة برمجة التطبيقات (API): مقاييس الحساب والمنشوراتالمقاييس التي تعيدها واجهة Instagram للحساب ولكل منشور وReels وقصة، مع حدود Meta وفترات التأخير والمقاييس المعاد تسميتها.تحليلات Reels في Instagram عبر واجهة برمجة التطبيقات (API)مقاييس Reels التي تعيدها API من Instagram: المشاهدات والوصول والإعجابات والمشاركات والحفظ ووقت المشاهدة ومعدل التخطي، والمقاييس المهملة وبدائلها.رؤى قصص Instagram عبر الواجهة البرمجيةمقاييس القصص التي تعيدها واجهة Instagram البرمجية، من الوصول والمشاهدات والردود إلى التنقل بالنقر والخروج، ومدة بقائها وسبب إرجاع بعضها الخطأ 10.مقاييس واجهة برمجة التطبيقات (API) المهملة في Instagram: تحل views محل impressions و playsالمقاييس التي أوقفتها Meta في 2025، ومنها impressions و plays و video_views، مع تواريخ الإيقاف وما يحل محل كل منها وما يجب تغييره في الشيفرة.أي حسابات Instagram تعمل مع واجهة برمجة التطبيقات (API): تجاري أو منشئ أو شخصييعمل API من Instagram مع الحسابات الاحترافية، التجارية أو المنشئ. أيهما تختار، وما الذي يتغير عند التحويل، وكيف تحوّل الحساب من التطبيق.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في