تخطَّ إلى المحتوى

تحليلات القناة

GET /public/v1/analytics/{integration}

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

إن كنت تفعل ذلك من التطبيق، فراجع التحليلات. وهذه العملية متاحة أيضًا بالأمر sharek analytics:platform في أداة CLI من شارك، ولا تقابلها أداة في خادم MCP.

المعامل مطلوب الوصف
integration نعم معرف القناة من سرد القنوات، لا اسم المزود.
المعامل مطلوب الوصف
date لا كم يومًا للوراء تغطى، كرقم. 7 أو 30 أو 90. والقيمة الافتراضية 7، وهي أيضًا ما تحصل عليه لأي قيمة ليست رقمًا موجبًا.
Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/analytics/channel-id?date=30"
[
{
"label": "Reach",
"percentageChange": 0,
"data": [
{ "total": 0, "date": "2026-08-18" },
{ "total": 0, "date": "2026-08-19" }
]
}
]
الحقل الوصف
label اسم المقياس، يختاره المزود. فقناة Instagram قد تعيد Follower Count وReach وLikes وViews وComments وShares وSaves وReplies؛ ومزودون آخرون يعيدون مجموعتهم الخاصة.
data السلسلة اليومية.
percentageChange دائمًا 0 حاليًا: فلا مزود يحسبه بعد، فلا تبن عليه.

المصفوفة الفارغة شائعة

Section titled “المصفوفة الفارغة شائعة”

تعاد []، بلا خطأ، حين:

  • لا يتيح المزود تحليلات. وكثيرون لا يتيحونها.
  • لا تكون القناة قناة اجتماعية.
  • ينتهي رمز القناة ويتعذر تجديده. وفي تلك الحالة يقطع اتصال القناة أيضًا وتظهر بأنها تحتاج انتباهًا في التطبيق.

فتحقق من [] قبل أن تفترض أن في التكامل خللًا.

الاستجابات تخزن مؤقتًا ساعة واحدة لكل قناة ولكل عدد أيام. والسؤال مرة أخرى داخل تلك الساعة يعيد الأرقام نفسها، فلا فائدة من تكرار الطلب بوتيرة أعلى.

الاستجابة المعنى
500 معرف القناة لا يخص مؤسستك. ويظهر ذلك كخطأ خادم لا كـ 404.

ولأرقام منشور واحد بدل أرقام القناة، استخدم تحليلات المنشور.