الانتقال إلى المحتوى الرئيسي
POST
احصل على تحليلات لحظية مثل الإعجابات والانطباعات والمشاهدات والتفاعلات لمنشور تم إرساله عبر Ayrshare باستخدام Ayrshare Post ID. للاطلاع على تحليلات المنشورات التي أُنشئت خارج Ayrshare، انظر التحليلات بواسطة معرّف المنشور الاجتماعي.
فيسبوك: أوقفت Meta بعض مقاييس الوصول والفيديو (15 يونيو 2026). أزالت Meta مقاييس Insights للانطباعات الفريدة ومشاهدات الفيديو لمدة 3 ثوانٍ عبر جميع إصدارات Graph API، لذا لم يعد كائن analytics الخاص بفيسبوك يُعيد impressionsUnique أو impressionsFanUnique أو impressionsOrganicUnique أو impressionsPaidUnique أو videoViewsUnique. استخدم mediaView للوصول (ثمة مقياس بديل لإجمالي مشاهدات الوسائط الفريدة قيد التخطيط). الحقول الأخرى شائعة الاستخدام مثل reactionsByType وvideoViews لم تتأثر. المرجع: تغييرات API القادمة — 15 يونيو 2026.

معلومات إضافية

  • المنصات التالية مدعومة حاليًا: Bluesky وFacebook Pages وInstagram وX/Twitter وLinkedIn وPinterest وReddit وSnapchat وThreads وTikTok وYouTube.
  • قد تختلف أعداد تعليقات فيسبوك وإنستجرام المعروضة في واجهة API عن الأعداد الظاهرة في التطبيقات الاجتماعية. يحدث ذلك لسببين: - لدى بعض المستخدمين إعدادات خصوصية تُخفي تعليقاتهم عن غير الأصدقاء أو المستخدمين بدون صلات متبادلة. تُدرَج هذه التعليقات الخاصة مع ذلك ضمن العدد الإجمالي للتعليقات. - قد يكون هناك تعارض في البيانات التي تُبلَغ من Meta.
  • قد تختلف قيم igReelsAggregatedAllPlaysCount وplaysCount لإنستجرام المعروضة في واجهة API عن الأعداد الظاهرة في التطبيقات الاجتماعية. يمكن أن يحدث ذلك لسببين:
    • تم الترويج للمنشور. تُدرَج فقط عمليات التشغيل العضوية في استجابة API.
    • قد يكون هناك تعارض في البيانات التي تُبلَغ من Meta.
  • تعود Threads في X/Twitter كمصفوفة من الكائنات، حيث يقابل كل كائن تغريدة في الـ Thread.
  • قد يستغرق YouTube 24-48 ساعة لمعالجة التحليلات لمقاطع الفيديو ذات عدد المشاهدات القليل أو المتابعين القليلين للقناة.
  • تحليلات TikTok:
    • قد يستغرق TikTok 24-48 ساعة لتحديث بيانات التحليلات، مثل مشاهدات الفيديو والديموغرافية والإعجابات والمشاركات والتعليقات.
    • للوصول إلى تحليلات TikTok، يجب على أصحاب الحسابات: 1. نشر فيديو واحد على الأقل. 2. النقر على زر “Turn On” في صفحة Analytics بتطبيق TikTok على الهاتف. 3. امتلاك 100 متابع لتلقي رؤى إضافية حول المشاهدين والتفاعل مع المحتوى.
    • لا يُعيد TikTok تحليلات المنشور إذا كانت الوسائط تحتوي مادة محمية بحقوق النشر أو تم الإبلاغ عنها بمخالفة حقوق نشر. من أمثلة المواد المحمية الصوت في Reels (سيقوم TikTok بكتم صوت هذه المقاطع). يمكنك التحقق في تطبيق TikTok ضمن Activity -> System Notifications.
    • قد تكون بعض حقول تحليلات TikTok غير متاحة إذا ظل الفيديو غير نشط لأكثر من 7 أيام. لاسترداد هذه البيانات، أنشئ نشاطًا جديدًا على الفيديو (مشاهدة أو إعجاب أو تعليق أو مشاركة) وأعد المحاولة بعد 24-48 ساعة. إذا لم يُعَد الفيديو في الاستجابة، فمن المرجّح أن السبب هو تصفية الفيديو بسبب مخالفات، مثل انتهاك حقوق نشر الموسيقى. تشمل هذه الحقول:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • تُعيد ملفات LinkedIn الشخصية (للأعضاء) الآن مصفوفة موسّعة من تحليلات المنشور. المقاييس المتاحة للعضو هي:
    • impressionCount — الانطباعات على المنشور
    • uniqueImpressionsCount — الأعضاء الفريدون الذين تم الوصول إليهم (LinkedIn MEMBERS_REACHED)
    • likeCount — عدد التفاعلات
    • commentCount — عدد التعليقات
    • shareCount — إعادات مشاركة المنشور
    • engagement — النقرات والإعجابات والتعليقات والمشاركات العضوية مقسومة على الانطباعات
    • reactions — تفصيل التفاعلات حسب النوع (عندما تكون التفاعلات موجودة)
    • لمنشورات الفيديو: videoViews وvideoViewers وvideoWatchTimeMs
    تُعاد مقاييس الفيديو فقط لمنشورات الفيديو وتصبح غير متاحة بعد مرور أكثر من عام على إنشاء المنشور.
  • رؤى قصص إنستجرام متاحة فقط لمدة 24 ساعة، بصرف النظر عن أرشفة القصص أو تمييزها. ملاحظة:
    • تعود مقاييس وسائط القصص التي تقل قيمها عن 5 بقيمة 0.
    • بالنسبة للقصص التي ينشئها مستخدمون في أوروبا واليابان، يُعيد مقياس replies القيمة 0.
  • تحليلات قصص فيسبوك غير متاحة.
  • تصبح بيانات تحليلات Pinterest (الانطباعات والمتابعون والنقرات) متاحة بعد 24-72 ساعة.
  • بالنسبة لـ YouTube Shorts، يُعيد عدد المشاهدات عدد مرات بدء تشغيل أو إعادة تشغيل الـ Short، دون اشتراط حد أدنى لوقت المشاهدة.

معاملات الترويسة

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

id
string
مطلوب
Ayrshare Post ID المُعاد من نقطة النهاية /post. هذا هو id الرئيسي المُعاد من Ayrshare وليس معرّفات المنشورات الاجتماعية في postIds.
platforms
array
مصفوفة نصية للمنصات المراد استرداد تحليلاتها. تقبل مصفوفة من السلاسل النصية بالقيم:
إذا لم تُضمَّن platforms، ستُعاد التحليلات لجميع شبكات التواصل الاجتماعي التي أُرسل إليها المنشور.
When cumulative metrics (e.g., likes, comments, views) are temporarily unavailable from the social network, the API automatically backfills them from stored data. Two optional fields may appear in the per-platform analytics object:
  • backfilledFrom (string, ISO 8601) — Present when one or more cumulative metrics were substituted from stored data. The timestamp indicates when the stored data was last updated.
  • recoveredFrom (string, ISO 8601) — Present when the entire analytics response was recovered from stored data due to a complete API failure. The timestamp indicates when the stored data was last updated.
Stored data older than 4 days is considered stale and will not be used for backfill or recovery.
LinkedIn personal (member) analytics — re-link required. Personal LinkedIn profiles linked before member post analytics shipped do not have the required analytics scopes. Analytics requests for those profiles return error code 475 (“re-link your LinkedIn profile to enable analytics”). The account owner must re-link their LinkedIn profile on the Social Accounts page to grant the new scopes. Allow a few minutes after re-linking for code 475 to clear (Ayrshare and LinkedIn both briefly cache the permission state, typically ~5-10 minutes). Posting is unaffected.LinkedIn member post counts are best-effort: the aggregate shareCount (RESHARE), likeCount (REACTION), and commentCount (COMMENT) totals may differ slightly from the numbers shown in the LinkedIn UI.