اعرض إحصاءات المنشأة

يعيد أحدث الأرقام الصالحة التي جمعتها Sofia لكل حساب متصل. الحساب الذي لم يُجمع بعد يظهر awaiting، وليس صفرًا أبدًا.

GEThttps://api.sofia-post.com/api/v1/establishments/{id}/insights

GET/v1/establishments/{id}/insights

مفتاح API أو رمز وصوليبقى في هذا التبويب فقط، ويُرسل إلى api.sofia-post.com فقط.id (path)period (query)

curl -X GET 'https://api.sofia-post.com/api/v1/establishments/{id}/insights' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

التفويضات

Authorizationstringمطلوب
مفتاحك الشخصي أو رمز وصول OAuth، يُرسل كـ Bearer <token>.

معاملات المسار

idstringمطلوب
معرّف المنشأة.

معاملات الاستعلام

periodstring
الفترة؛ آخر 28 يومًا عند الحذف.
القيم المسموحة: last24Hourslast7Dayslast28Days

الاستجابة

200application/json

أرقام كل حساب متصل.

establishmentIdstringمطلوب
معرّف المنشأة
periodstringمطلوب
الفترة التي تغطيها الأرقام
القيم المسموحة: last24Hourslast7Dayslast28Days
dataobject[]مطلوب
أرقام كل حساب متصل
عرض الخصائص الفرعية
- platformstringمطلوب
  معرّف منصة الشبكة
- viewsobjectمطلوب
  عدد مرات عرض المحتوى أو تشغيله. تسميه Instagram views؛ وقد يحسب الحساب نفسه أكثر من مرة، فلا يصح أن يحل محل الوصول.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- reachobjectمطلوب
  الحسابات الفريدة التي رأت المحتوى مرة واحدة على الأقل خلال الفترة.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- reachDeltaPercentobjectمطلوب
  تغيّر الوصول مقارنةً بالفترة السابقة، بنسبة مئوية موقّعة.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- accountsEngagedobjectمطلوب
  الحسابات الفريدة التي تفاعلت مع المحتوى.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- totalInteractionsobjectمطلوب
  الإعجابات والتعليقات والحفظ والمشاركات وغيرها من التفاعلات المدعومة.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- likesobjectمطلوب
  الإعجابات خلال الفترة.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- commentsobjectمطلوب
  التعليقات خلال الفترة.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- sharesobjectمطلوب
  المشاركات خلال الفترة.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- savesobjectمطلوب
  عمليات الحفظ خلال الفترة.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- engagementRatePercentobjectمطلوب
  إجمالي التفاعلات مقسومًا على الحسابات التي وصل إليها، بالنسبة المئوية. تحسبه Sofia، وليس رقمًا تبلغ عنه المنصة. غير متاح عندما يكون الوصول مفقودًا أو صفرًا.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- engagementDeltaPointsobjectمطلوب
  تغيّر معدل التفاعل مقارنةً بالفترة السابقة، بالنقاط.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- followersDeltaobjectمطلوب
  صافي تغيّر المتابعين خلال الفترة. تحجبه Meta لحسابات Instagram التي لديها أقل من 100 متابع، ويُبلَّغ عنه below-follower-threshold وليس كخطأ ولا كـ 0.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobjectمطلوب
  المنشورات المنشورة خلال الفترة.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- followersTotalobjectمطلوب
  العدد المطلق للمتابعين كما يبلغ عنه الملف المتصل. في Instagram يأتي من instagram_business_basic وليس من Insights. تعني available مع القيمة 0 أن المنصة أبلغت عن صفر؛ والغياب هو unavailable مع سببه، فالاثنان ليسا الرقم نفسه أبدًا.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- postsTotalobjectمطلوب
  العدد المطلق للمنشورات على الشبكة، طوال الوقت، كما يبلغ عنه الملف المتصل. العقد نفسه مثل followersTotal: يبقى الصفر المبلغ عنه صفرًا، ويبقى الغياب غيابًا.
  عرض الخصائص الفرعية
  - statusstringمطلوب
    هل أبلغت المنصة فعلًا بهذا المقياس. قد تحمل available القيمة 0، وهي صفر مقيس. أما unavailable فلا تحمل قيمة أبدًا.
    القيم المسموحة: availableunavailable
  - valuenumber
    الرقم المقيس. يظهر فقط عندما تكون الحالة available؛ والقيمة 0 قيمة حقيقية.
  - reasonstring
    سبب غياب المقياس. below-follower-threshold تعني أن Meta تحجب مقاييس الجمهور لما دون 100 متابع، وليست خطأً. permission-denied نطاق Insights مفقود على الحساب المتصل، ودائم حتى يعيد المالك الربط، وليس عابرًا أبدًا. not-collected أن Sofia نفسها لا تقيس هذا الرقم على نقطة النهاية هذه بعد، ولم تُسأل المنصة، فلا لوم عليها.
    القيم المسموحة: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة؛ تنشر Instagram بعض الأرقام متأخرة حتى 48 ساعة.
  - sourceMetricstring
    حقل المنصة الذي يأتي منه هذا الرقم، full_video_watched_rate على TikTok وpost_video_view_time على Facebook. تسمّي شبكتان أشياء مختلفة باسم «الإكمال»؛ ومن دون هذا الحقل سيضع التقرير الرقمين جنبًا إلى جنب كأنهما قابلان للمقارنة.
  - granularitystring
    ما يغطيه الرقم: إجمالي طوال العمر، أو ساعة، أو يوم، أو الفترة المطلوبة كلها كما جمّعتها الشبكة، أو ثانية فيديو واحدة. السلسلة اليومية والمجمّع للفترة وإجمالي العمر ليست القياس نفسه، فلا تُرسم على المحور نفسه ولا يُجمع بعضها إلى بعض.
    القيم المسموحة: lifetimehourdayperiodvideo-second
- hasInsightsDatabooleanمطلوب
  صحيح عندما نجح استدعاء Insights واحد على الأقل. تأتي أعداد المتابعين والمنشورات أيضًا من نطاق الملف الأساسي، فوجودها وحده لا يثبت أن Insights قابلة للقراءة.
- mayBeDelayedbooleanمطلوب
  صحيح ما دامت المنصة قد تواصل استكمال هذه النافذة (حتى 48 ساعة).
- socialAccountIdstringمطلوب
  الحساب المتصل الذي تخصه هذه الأرقام.
- collectionobjectمطلوب
  وقائع التجميع وراء هذه الأرقام.
  عرض الخصائص الفرعية
  - statestringمطلوب
    awaiting-first-collection: الحساب متصل ولا توجد إجابة صالحة بعد، وكل مقياس يظهر not-collected.
    القيم المسموحة: collectedawaiting-first-collection
  - isOutdatedbooleanمطلوب
    صحيح عندما لم تنجح محاولة لاحقة، أو تأخر التجميع التالي أكثر من ساعة. تبقى الأرقام صالحة لنافذتها وتاريخها؛ لكنها ليست حالية.
  - isCollectingbooleanمطلوب
    صحيح أثناء تشغيل عملية تجميع لهذا الحساب.
  - collectedAtnumber
    وقت إجابة الشبكة (unix ms).
  - windowStartnumber
    بداية النافذة التي طُلبت من الشبكة (unix ms).
  - windowEndnumber
    نهاية النافذة التي طُلبت من الشبكة (unix ms).
  - completenessstring
    partial: أجابت الشبكة عن جزء من النافذة فقط، أو فشلت بعض المقاييس.
    القيم المسموحة: completepartial
  - nextCollectionAtnumber
    وقت استحقاق التجميع التالي (unix ms).
  - lastFailedAttemptobject
    آخر محاولة، عندما انتهت بعد الأرقام المعروضة ولم تنجح.
    عرض الخصائص الفرعية
    atnumberمطلوب
    وقت انتهاء المحاولة (unix ms)
    outcomestringمطلوب
    deferred: طلبت الشبكة من Sofia الانتظار (حد معدل أو حصة). failed: أي شيء آخر.
    القيم المسموحة: faileddeferred
    reasonstring
    السبب كما صنّفته Sofia (reauthentication-required وplatform-error…).
- reachDailySeriesnumber[]
  قيم الوصول اليومية. تغيب عندما لا تعيد المنصة سلسلة، ولا تُملأ بأصفار أبدًا.
- engagementDailySeriesnumber[]
  معدل التفاعل اليومي بالنسبة المئوية. يغيب في Instagram: لا يملك total_interactions وضع سلسلة زمنية، فلا يوجد معدل يومي صادق.
- followersDailySeriesnumber[]
  صافي تغيّر المتابعين يوميًا. يغيب عندما لا تبلغ المنصة عنه.
- fetchedAtnumber
  وقت إجابة الشبكة (unix ms). يغيب حتى ينجح أول تجميع.

401

الرمز مفقود أو غير معروف أو منتهي الصلاحية أو ملغى.

403

لا يملك الرمز النطاق insights:read.

404

منشأة خارج مساحة عمل الرمز.

4XXapplication/json

أي خطأ آخر، ضمن غلاف الخطأ.

اعرض إحصاءات المنشأة

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/establishments/<id>/insights' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "establishmentId": "string",
  "period": "last24Hours",
  "data": [
    {
      "platform": "instagram",
      "views": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reach": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDeltaPercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "accountsEngaged": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "totalInteractions": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "likes": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "comments": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "shares": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "saves": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementRatePercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementDeltaPoints": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "followersDelta": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsPublishedDuringPeriod": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDailySeries": [
        0
      ],
      "followersDailySeries": [
        0
      ],
      "followersTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "hasInsightsData": true,
      "mayBeDelayed": false,
      "fetchedAt": 1739539200000,
      "socialAccountId": "acc_123",
      "collection": {
        "state": "collected",
        "collectedAt": 1739539200000,
        "completeness": "complete",
        "isOutdated": false,
        "isCollecting": false
      }
    }
  ]
}