API التحليلاتAPI

اقرأ مقاييس كل شبكة من نقطة نهاية واحدة

يجمع FoPost بيانات الأداء من كل حساب متصل ويعيدها إليك بشكل واحد متّسق. اسحب نظرة عامة على مساحة العمل، أو تعمّق في منشور، أو تتبّع حسابًا عبر الزمن، ومرّر النتائج إلى أي أداة تعدّ بها تقاريرك.

GET /v1/analytics/overview
curl "https://api.fopost.com/v1/analytics/overview?workspace_id=9b2f6c1e-...&days=30" \
  -H "X-API-Key: $API_KEY"

{
  "total_accounts": 6,
  "total_followers": 42810,
  "total_posts": 86,
  "total_engagement": 9127,
  "total_impressions": 184320,
  "total_reach": 121904,
  "engagement_rate": 0.0749,
  "deltas": { "followers": 2.89, "posts": 12.5 },
  "today_stats": { "posts": 3, "follower_change": 41, "engagement": 312 },
  "platforms": [{ "platform": "linkedin", "accounts": 2, "followers": 18402 }]
}

مقاييس موحّدة

مرات الظهور والتفاعل والمتابعون تحمل أسماء الحقول نفسها في كل شبكة.

ثلاثة مستويات

نظرة عامة على مساحة العمل، أو منشور واحد، أو حساب واحد.

صلاحية قراءة فقط

المفتاح الذي يحمل صلاحية analytics وحدها يقرأ الأرقام ولا يفعل شيئًا آخر.

نظرة عامة

طلب واحد للتقرير الشهري

تجمع نقطة نهاية النظرة العامة أرقام مساحة العمل خلال نطاق زمني: إجمالي مرات الظهور والتفاعلات وتغيّر المتابعين والمنشورات المنشورة، فيصبح الملخص الأسبوعي أو تقرير العميل طلبًا واحدًا وقالبًا.

اقرأ مرجع التحليلات
حسابات متصلة عبر كل الشبكات في مساحة عمل واحدة

النطاقات الزمنية

مرّر days لنافذة سابقة تصل إلى 365 يومًا. وتقارن الفروق بينها وبين النافذة التي قبلها.

التصفية حسب الحساب

ضيّق النظرة العامة إلى حساب واحد حين يسأل عميل عن قناة واحدة.

لكل مساحة عمل

مفاتيح الوكالة خاصة بمساحة عمل كل عميل، فلا تتداخل التقارير أبدًا.

لكل منشور

اكتشف أي منشور حقّق النتيجة

كل منشور تنشئه عبر API يحتفظ بمعرّفه، وهذا المعرّف يقرأ المقاييس من كل شبكة وصل إليها. اربطه ببيانات حملاتك، أو رتّب منشورات الشهر لترى ما يستحق التكرار.

اطّلع على مقاييس كل منشور
GET /v1/posts/:id/analytics
curl "https://api.fopost.com/v1/posts/7d3e0a52-.../analytics" \
  -H "X-API-Key: $API_KEY"

{
  "post_id": "7d3e0a52-...",
  "totals": { "impressions": 21050, "reach": 15230, "engagements": 1374, "likes": 501, "comments": 60, "shares": 71, "reposts": 0, "clicks": 721, "saves": 21, "video_views": 0, "follows": 12 },
  "platforms": [
    { "platform": "linkedin", "username": "yourbrand", "external_post_id": "urn:li:share:7301...", "permalink": "https://linkedin.com/feed/update/...", "metrics": { "impressions": 12840, "likes": 311, "comments": 42, "shares": 27, "clicks": 508 } },
    { "platform": "twitter", "username": "yourbrand", "external_post_id": "1830...", "permalink": "https://x.com/...", "metrics": { "impressions": 8210, "likes": 190, "comments": 18, "shares": 44, "clicks": 213 } }
  ],
  "last_fetched_at": "2026-09-02T09:00:00Z"
}

تفصيل لكل حساب

منشور واحد وصف واحد لكل شبكة، فترى أي قناة حملته.

النقرات والروابط الدائمة

تأتي نقرات الروابط والرابط الدائم المباشر مع الأعداد.

التجميع حسب التصنيف

اعرض المنشورات حسب التصنيف أولًا، ثم اقرأ مقاييس المجموعة.

لكل حساب

تتبّع النمو على كل قناة عبر الزمن

تُعيد نقطة نهاية الحساب سلسلة لقطات لعدد المتابعين والوصول ومشاهدات الملف الشخصي. غذِّ بها رسومك البيانية، أو أطلق تنبيهًا عند الانخفاض، أو أرِ عميلك الخط الصاعد بجوار المنشورات التي حرّكته.

ابدأ البناء
GET /v1/accounts/:id/analytics
curl "https://api.fopost.com/v1/accounts/4a71d80b-.../analytics?limit=7" \
  -H "X-API-Key: $API_KEY"

{
  "account_id": "4a71d80b-...",
  "platform": "linkedin",
  "username": "yourbrand",
  "history": [
    { "followers": 41651, "following": 210, "total_posts": 412, "reach": 6034, "profile_views": 341, "fetched_at": "2026-08-02T06:00:00Z" },
    { "followers": 41606, "following": 210, "total_posts": 411, "reach": 5120, "profile_views": 288, "fetched_at": "2026-08-01T06:00:00Z" }
  ]
}

سلسلة لقطات

نقطة واحدة لكل دورة جمع للمتابعين والوصول ومشاهدات الملف الشخصي.

أنشئ تنبيهاتك الخاصة

استعلم وفق جدول وأرسل إشعارًا حين تخرج قناة عن نطاقها المعتاد.

امتلك السجل التاريخي

خزّن السلسلة في مستودع بياناتك واحتفظ بها المدة التي تريدها.

أسئلة حول API التحليلات، مع إجاباتها

من أين تأتي الأرقام؟

يقرأ FoPost تحليلات كل شبكة باستخدام بيانات اعتماد الحساب المتصل، ثم يوحّد أسماء الحقول. وتطابق الأرقام ما تعرضه الشبكة في لوحة تحكمها الأصلية.

ما مدى حداثة البيانات؟

تتحدّث المقاييس وفق جدول لكل حساب متصل. يُظهر المنشور المنشور اليوم أرقامًا أولية خلال ساعات، ثم تستقر حين تعتمد الشبكة أعدادها النهائية.

هل تُبلغ كل الشبكات عن المقاييس نفسها؟

المجموعة الأساسية من مرات الظهور والتفاعلات والمتابعين مشتركة. والمقاييس التي لا تتيحها شبكة ما تُعاد بالقيمة null لا صفرًا، فتميّز بين الغائب والفارغ.

هل يمكنني الحصول على مقاييس منشورات نُشرت خارج API؟

نعم. يُتتبَّع أي منشور نُشر عبر الحساب المتصل على مستوى الحساب، والمنشورات التي أُنشئت في لوحة التحكم لها معرّفات كأي منشور آخر.

ما الصلاحية التي أحتاجها؟

صلاحية analytics. المفتاح الذي لا يحمل غيرها للقراءة فقط، ولا يستطيع النشر أو التعديل أو إدارة الحسابات.

هل يوجد حدّ لمعدل الطلبات؟

نعم، 100 طلب في الدقيقة لكل مفتاح. اجمع القراءات بنطاقات زمنية بدلًا من طلب لكل يوم.

ابنِ على API التحليلات اليوم

البداية مجانية وواجهة API كاملة مُضمَّنة. أنشئ مفتاحًا ونفّذ أول طلب خلال دقائق.

احصل على مفتاح API