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

تحليلات Instagram عبر واجهة برمجة التطبيقات (API): مقاييس الحساب والمنشورات

تُرجع API الخاصة بـ Instagram تحليلات الحساب المهني، ولكل منشور من منشوراته وReels وقصصه. تشمل مقاييس الحساب الوصول والمشاهدات والحسابات المتفاعلة والمتابعات وإلغاء المتابعة والإعجابات والتعليقات والحفظ والمشاركات. وتشمل مقاييس المنشور الوصول والمشاهدات والإعجابات والتعليقات والحفظ والمشاركات. تشير Meta إلى أن البيانات قد تتأخر حتى 48 ساعة.

يقرأ easyCoexistence تحليلات Instagram باستخدام get_social_insights، فيمكنك أن تسأل Claude أو ChatGPT عن أداء منشورات الأسبوع الماضي، وتحصل على الوصول والمشاهدات والإعجابات والتعليقات والحفظ والمشاركات مباشرة من Meta، للحساب أو لمنشور واحد.

48 hours

المدة التي قد تتأخر فيها البيانات الخاصة بمقاييس Instagram.

100 followers

دون هذا الحد، لا تُعاد للحساب بيانات المتابعات وإلغاء المتابعة والتركيبة الديموغرافية للمتابعين.

2 years

المدة التي تحتفظ فيها Meta بمقاييس الوسائط.

24 hours

المدة التي تبقى فيها مقاييس القصص متاحة عبر API.

21 Apr 2025

متى توقفت impressions عن العمل في كل إصدارات API، باستثناء الوسائط المنشأة قبل 2 يوليو 2024؛ وحلّت محلها views.

ما المقاييس المتاحة للحساب؟

يُقرأ عبر GET /<IG_ID>/insights ويُستخدم غالبًا period=day وmetric_type=total_value:

  • reach: عدد الحسابات الفريدة التي شاهدت المحتوى، بما في ذلك الإعلانات؛ القيمة تقديرية.
  • views: عدد المرات التي شُغِّل فيها المحتوى أو عُرض.
  • accounts_engaged: الحسابات التي تفاعلت مع المحتوى، بما في ذلك الإعلانات؛ القيمة تقديرية.
  • follows_and_unfollows: المتابعات وإلغاءات المتابعة خلال الفترة؛ يلزم ما لا يقل عن 100 متابع.
  • الإعجابات والتعليقات والحفظ والمشاركات والردود وإعادة النشر، إضافة إلى total_interactions.
  • profile_links_taps: النقرات على أزرار العنوان التجاري والاتصال والبريد الإلكتروني والرسائل النصية.
  • follower_demographics وengaged_audience_demographics: العمر والمدينة والبلد والجنس.

ما مقاييس المنشور المتاحة؟

تُقرأ عبر GET /<IG_MEDIA_ID>/insights بحسب الصيغة، وتختلف المقاييس المتاحة باختلافها. تحتسب الإعجابات والتعليقات والمشاهدات وإجمالي التفاعلات في المنشور أو Reel النشاط العضوي فقط، ولا تشمل التفاعل مع الإعلانات المنشأة منه.

  • المنشورات وReels: الوصول (reach) والمشاهدات (views) والإعجابات (likes) والتعليقات (comments) والحفظ (saved) والمشاركات (shares) وإعادة النشر (reposts) وtotal_interactions.
  • Reels فقط: ig_reels_avg_watch_time وig_reels_video_view_total_time وreels_skip_rate.
  • المنشورات والقصص: follows وprofile_visits وprofile_activity.
  • القصص: reach وviews وshares وreplies وnavigation وreposts وtotal_interactions.

ما عمل كلٌّ من period وmetric_type والتفصيلات؟

تأخذ مقاييس الحساب period=day. تُرجع metric_type=total_value قيمة واحدة للفترة، وهي ما تحتاجه التفصيلات؛ أما time_series فتُرجع قيمة لكل يوم، وهي متاحة للوصول. تقسّم التفصيلات الإجمالي حسب media_product_type (المنشورات والكاروسيل وReels والقصص والإعلانات)، أو حسب follow_type (متابعون أم لا)، أو حسب contact_button_type.

تأخذ المقاييس الديموغرافية قيمة timeframe مثل this_week أو this_month بدل since وuntil. ومن دونهما تعود المقاييس الأخرى إلى آخر 24 ساعة. يؤدي طلب تفصيلٍ لا يدعمه أحد المقاييس المطلوبة إلى فشل الطلب كله بخطأ unknown error.

ما حدود الظهور والتأخير المطبقة؟

قواعد Meta لمتى يظهر الرقم وكم تبقى متاحة:

  • قد تتأخر البيانات حتى 48 ساعة.
  • الحسابات التي تقل عن 100 متابع لا تحصل على follows_and_unfollows ولا على follower_demographics. أما engaged_audience_demographics فيلزمها 100 تفاعل ضمن الإطار الزمني.
  • البيانات المفقودة أو غير المتاحة تُعاد كمجموعة فارغة لا كصفر.
  • المقاييس الديموغرافية تُعيد أعلى 45 قيمة فقط.
  • تُحفظ مقاييس الحساب حتى 90 يومًا، ومقاييس الوسائط حتى سنتين.

ما المختلف في القصص والكاروسيل؟

مقاييس القصص متاحة 24 ساعة فقط، وإذا كانت القيمة أقل من 5 تُعيد رمز الخطأ 10 (عدد غير كافٍ من المشاهدين) بدلًا من رقم. تُستبعد الردود من أشخاص في أوروبا واليابان، وتُسجّل القصة التي ينشئها حساب هناك 0 ردود. مع Instagram Login لا يوجد خطاف الويب (webhook) باسم story_insights، لذلك يجب قراءة أرقام القصص أثناء بقائها منشورة.

يُسجَّل الكاروسيل كمنشور واحد: لا تُعيد Meta أي مقاييس للصور والفيديوهات داخله.

لماذا تتغير أسماء المقاييس؟

لأن Meta تُوقف المقاييس وتعيد تسميتها بين إصدارات API. كان impressions مُهمَلًا في v22.0 وتوقف عن العمل في كل الإصدارات في 21 أبريل 2025، باستثناء الوسائط المنشأة قبل 2 يوليو 2024، وحلّت محله views. وتوقفت في الوقت نفسه plays وclips_replays_count وig_reels_aggregated_all_plays_count. وسبق إسقاط video_views وعدد من سلاسل الملف الزمنية، ومنها profile_views. يفشل الطلب الذي يحمل اسمًا متقاعدًا، لذلك قد تحتاج قائمة مقاييس كُتبت لإصدار سابق من API إلى تحديث.

الأخطاء الشائعة

  • طلب impressions لم يعد يعمل في أي إصدار من API. اطلب views بدلًا منه.
  • اعتبار النتيجة الفارغة صفرًا. تُعيد Meta مجموعة بيانات فارغة عندما يكون المقياس غير متاح، وهذا لا يعني عدم وجود نشاط.
  • قراءة مقاييس القصة بعد انتهائها. لا تتوفر إلا لمدة 24 ساعة.
  • إضافة تفصيل إلى طلب يضم عدة مقاييس. إذا لم يدعمه أحدها، يفشل الاستدعاء كله.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

بماذا استُبدل impressions في واجهة Instagram البرمجية؟

المقياس البديل هو views ويحسب عدد المرات التي شُغِّل فيها المحتوى أو عُرض. أوقفت Meta impressions في كل إصدارات API في 21 أبريل 2025، باستثناء الوسائط المنشأة قبل 2 يوليو 2024.

لماذا لا يُعيد حسابي بيانات المتابعين؟

لا تُعيد Meta البيانات follows_and_unfollows ولا التركيبة الديموغرافية للمتابعين للحسابات التي تقل عن 100 متابع.

إلى أي مدى يمكنني قراءة تحليلات Instagram؟

حتى 90 يومًا لمقاييس الحساب، وحتى سنتين لمقاييس الوسائط، غير أن online_followers تغطي آخر 30 يومًا فقط.

هل تشمل الأرقام الإعلانات؟

جزئيًا. يشمل الوصول والحسابات المتفاعلة للحساب الإعلانات، بينما تحسب الإعجابات والتعليقات والمشاهدات الخاصة بالمنشور النشاط العضوي فقط.

تابع القراءة

أي حسابات Instagram تعمل مع واجهة برمجة التطبيقات (API): تجاري أو منشئ أو شخصييعمل API من Instagram مع الحسابات الاحترافية، التجارية أو المنشئ. أيهما تختار، وما الذي يتغير عند التحويل، وكيف تحوّل الحساب من التطبيق.نشر Reels على Instagram عبر واجهة برمجة التطبيقات (API)كيف ينشر API من Instagram مقاطع Reels: متطلبات Meta للفيديو، والحاويات ومدة المعالجة، والمشاركة في Feed، والأغلفة، والمقاييس.نشر قصص Instagram عبر واجهة برمجة التطبيقات (API)كيف تنشر API القصص في Instagram: متطلبات الصورة والفيديو، ومدة 24 ساعة، والردود كرسائل مباشرة، والمقاييس المتاحة.منشورات الكاروسيل على Instagram عبر واجهة برمجة التطبيقات (API)كيف تنشر API في Instagram كاروسيلات تضم حتى 20 صورة وفيديو: حاويات العناصر، ووصفًا واحدًا، وقص الصور وفق الأولى، والحدود.أخطاء واجهة برمجة التطبيقات (API) في Instagram: معنى الرموز الشائعةأخطاء Instagram API الشائعة ومعانيها: رموز الوصول المنتهية، وحدود المعدل، والوسائط التي لا يستطيع Meta جلبها، وحد النشر، ونوافذ الرسائل المغلقة.

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

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

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

تم التحقق في