الانتقال إلى المحتوى الرئيسي
GET
احصل على التعليقات لمنشور باستخدام معرّف منشور Ayrshare، أو معرّف المنشور الاجتماعي، أو معرّف تعليق Ayrshare، أو معرّف التعليق الاجتماعي مع Comment API. يرجى الاطلاع على نظرة عامة على التعليقات لمزيد من المعلومات حول أنواع المعرّفات المختلفة.
عند استخدام معرّف منشور Ayrshare، لا توجد معلمات استعلام مطلوبة.

تفاصيل إضافية للتعليقات

  • يتم تحديث بيانات التعليقات كل 10 دقائق لجميع المنصات، باستثناء X. بسبب القيود التي تفرضها X API، يتم تحديث بيانات التعليقات لـ X باستخدام استراتيجية التراجع الأسي (exponential backoff)، مما يعني أن الفترات بين التحديثات تزداد تدريجيًا بمرور الوقت.
  • في استجابة Facebook، ردود التعليقات على الردود لها دائمًا نفس parent.id.
  • استرجع ردود LinkedIn على التعليقات بتعيين معلمات الاستعلام "commentId": true و "searchPlatformId": true وتقديم معرّف التعليق الاجتماعي في معلمة المسار.
  • يُعيد Facebook وInstagram أحدث 1,000 تعليق على المنشور. يرجى الاتصال بنا بشأن حدود أعلى في خطة Enterprise.
  • بالنسبة لمنشور TikTok الذي لا يزال قيد المعالجة (id الخاص به هو "pending")، يُعيد get-comments خطأً واضحًا “لا يزال قيد المعالجة” (code: 288، HTTP 400) بدلاً من فشل عام. أعد المحاولة بمجرد إطلاق webhook tikTokPublished أو ظهور معرّف الفيديو المُحلَّل في /history.

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

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

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

searchPlatformId
boolean
افتراضي:false
عند الحصول على التعليقات على منشور تم نشره عبر Ayrshare واستخدام معرّف منشور Ayrshare، لا تُضمِّن هذا الحقل - القيمة الافتراضية هي false. عند الحصول على التعليقات باستخدام معرّف المنشور الاجتماعي أو معرّف التعليق الاجتماعي، وهو المعرّف الذي تُنشئه شبكات التواصل الاجتماعي، عيّنه على true.
commentId
boolean
افتراضي:false
إذا كنت تحصل على التعليقات باستخدام معرّف التعليق الاجتماعي، وهو معرّف التعليق الذي تُنشئه شبكات التواصل الاجتماعي، عيّنه على true.إذا كنت تحصل على تعليق باستخدام معرّف منشور Ayrshare أو معرّف المنشور الاجتماعي، لا تُضمِّن هذا الحقل - القيمة الافتراضية هي false.
عند استخدام معلمة الاستعلام commentId، يجب أيضًا تعيين searchPlatformId على true.
platform
string
مطلوب إذا كان searchPlatformId أو commentId هو true.متى تستخدمه:
  • عند استخدام معرّف المنشور الاجتماعي وحقل "searchPlatformId": true. المنصات المدعومة: bluesky وfacebook وinstagram و linkedin وthreads وtiktok وtwitter وyoutube.
  • عند استخدام معرّف التعليق الاجتماعي وحقلي "searchPlatformId": true و"commentId": true. المنصات المدعومة: facebook و instagram وlinkedin.
  • عند استخدام معرّف منشور Ayrshare، لا تُضمِّن هذا الحقل - ستتم إعادة التعليقات من جميع المنصات التي نُشر عليها المنشور الأصلي.

أمثلة على طلب GET للتعليقات