عرض منشورات صفحة فيسبوك عبر واجهة برمجة التطبيقات (API): feed وposts وpublished_posts
تُقرأ منشورات صفحة فيسبوك من ثلاث حواف في Graph API: /{page-id}/feed يعيد خلاصة الصفحة، بما فيها منشورات الزوار والمنشورات العامة التي تذكر الصفحة، و/{page-id}/posts يعيد منشورات الصفحة نفسها، و/{page-id}/published_posts يعيد منشوراتها المنشورة. يعيد الطلب الواحد ما يصل إلى 100 منشور، وتأتي الصفحات التالية عبر المؤشر، وتُرجع Meta نحو 600 منشور مُنشَر ومرتّب في السنة.
يعرض easyCoexistence أحدث منشورات صفحة فيسبوك عبر list_social_posts من Claude أو ChatGPT أو من شيفرتك البرمجية، حتى 100 في كل استدعاء.
أكبر عدد من المنشورات يمكن لطلب واحد قراءته عبر limit؛ طلب أكثر من ذلك يعيد خطأ.
عدد المنشورات المرتّبة والمنشورة في السنة التي تعيدها API عند قراءة منشورات صفحة.
الحقل الذي يفصل المنشورات المنشورة عن غير المنشورة، وهي تعيدها حافة feed معًا.
حافة الصفحة التي تشير إليها مرجعية feed لدى Meta لعرض الريلز المنشورة على الصفحة.
رابط الترقيم الذي يُتابَع حتى يختفي؛ الصفحة القصيرة أو الفارغة لا تعني نهاية النتائج.
منشورات الصفحة الخاصة، وتصفها مرجعية الصفحة لدى Meta بأنها مشتقة من الحافة /feed.
ما الفرق بين feed وposts وpublished_posts؟
من كتب المنشور وهل نُشر بعد. تصف مرجعية الصفحة لدى Meta الحواف الثلاث الرئيسية وثلاث حواف أضيق بهذه الطريقة، لكن feed تعيد أيضًا المنشورات غير المنشورة إلى جانب المنشورة، ويفصل بينها الحقل is_published:
ما الحقول التي يستحق طلبها؟
اطلبها بالاسم في fields: مثال Meta الخاص بقراءة منشورات صفحة يعيد id وcreated_time وmessage. وتسرد مرجعية Page Post لدى Meta هذه ضمن حقول المنشور:
- id وmessage و
created_time: المنشور ونصه ووقت نشره. permalink_url: العنوان الدائم للمنشور على facebook.com.full_picture: الصورة كاملة الحجم من مرفقه.status_typeوis_publishedوscheduled_publish_time.- shares، مع عدد مرات مشاركة المنشور.
- attachments وcomments وreactions، وهي حواف لا حقول بسيطة.
كيف تحصل على عدد التفاعلات والتعليقات؟
بتوسيع الحقول أثناء قراءة المنشورات. تضيف reactions.summary(total_count) عدد التفاعلات، وتشير Meta إلى أن عدد الإعجابات يشمل care. ويحمل shares عدّه الخاص. وتعيد حافة comments القيمة total_count عند طلب summary، وتقول Meta إنها قد تتجاوز عدد التعليقات المعادة بسبب الخصوصية أو الحذف.
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25كيف يعمل الترقيم؟
بالمؤشر. تحمل كل استجابة paging مع مؤشرَي before وafter ورابطي next وprevious؛ تابِع next حتى يختفي. تحذّر Meta من اعتبار الصفحة التي تحتوي نتائج أقل من limit نهاية، فقد تكون فارغة وما زالت تحمل next. وقد تصبح المؤشرات غير صالحة بسرعة مع إضافة العناصر أو حذفها، لذا لنطاق تعود إليه استخدم since وuntil.
ما الحدود المطبّقة؟
تحدد مرجعية feed لدى Meta هذه الحدود لقراءة منشورات الصفحة:
- 100 منشور لكل طلب عبر limit؛ القيمة الأكبر تعيد خطأ يطلب عدم تجاوز 100.
- نحو 600 منشور مُنشَر ومرتّب في السنة.
- لا يمكن عرض محتوى المنشور المنتهي عبر Graph API.
- عرض منشورات الفيديو يتطلب أن يكون صاحب الطلب مشرفًا على الصفحة.
- قد لا يكون المنشور الذي يشارك منشورًا لشخص آخر مرئيًا إذا لم يكن الأصلي مرئيًا للرمز المستخدم.
- تظهر تفاصيل الأشخاص في الاستجابات فقط عندما يستخدم الطلب رمز الوصول (token) الخاص بالصفحة.
أين تُعرض الريلز والقصص؟
في حواف خاصة بها. تشير مرجعية feed لدى Meta إلى حافة video_reels للصفحة لعرض الريلز المنشورة عليها، ويعرضها GET /{page-id}/video_reels مع since وuntil. ويعرض GET /{page-id}/stories قصص الصفحة بحالة PUBLISHED أو ARCHIVED، والمؤرشفة منها فقط ما دام أرشيف قصص الصفحة مفعّلًا.
ماذا يعيد list_social_posts لصفحة؟
أحدث منشورات الصفحة من /{page-id}/posts، بعدد 25 افتراضيًا وحتى 100 في كل استدعاء، مع id وmessage وcreated_time وpermalink_url وfull_picture، إلى جانب مؤشرات الترقيم لدى Meta. لا يطلب أي عدادات ويقرأ صفحة واحدة من النتائج: يقرأ list_social_comments تعليقات المنشور، ويقرأ get_social_insights مقاييس المنشور مع معرّفه بصفة object_id.
كيف تعرض المنشورات التي أُنشئت عبر easyCoexistence؟
بواسطة list_scheduled_posts، الذي يعرض المنشورات التي أُنشئت عبر easyCoexistence، سواء نُشرت الآن أو جُدولت: القادمة الأقرب أولًا، أو حسب الحالة، أو منشور واحد بواسطة post_id. يحمل كل منها حالته (scheduled أو publishing أو processing أو published أو failed أو canceled)، وpublish_at، ورابطه بعد النشر، والخطأ إن فشل. وتعرض شاشة المنشورات في لوحة التحكم هذه المنشورات تحت: «تحتاج إلى انتباه» و«قادمة» و«منشورة».
الأخطاء الشائعة
- توقّع عدادات من list_social_posts. يقرأ النص والوقت والرابط والصورة؛ تأتي مقاييس المنشور من get_social_insights مع معرّفه بصفة object_id.
- قراءة /feed لمنشورات الصفحة نفسها. تعيد أيضًا منشورات الزوار والمنشورات العامة التي تذكر الصفحة والمنشورات غير المنشورة؛ استخدم /published_posts، أو صفِّ حسب is_published.
- اعتبار الصفحة القصيرة هي الأخيرة. توقّف فقط عندما يختفي رابط next، فقد تكون الصفحة فارغة وما زال فيها next حسب Meta.
- حفظ المؤشرات لاستخدامها لاحقًا. تقول Meta إنها قد تصبح غير صالحة بسرعة مع إضافة المنشورات أو حذفها؛ احتفظ بقيم since وuntil بدلًا منها.
ويتابع list_scheduled_posts ما نُشر عبر easyCoexistence. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية لأول 3 أيام.
الأسئلة الشائعة
هل تتضمن حافة feed المنشورات المجدولة؟
تعيد المنشورات المنشورة وغير المنشورة معًا، فاقرأ is_published لتمييزها، أو استخدم GET /{page-id}/scheduled_posts للمنشورات المحددة لوقت لاحق.
هل تستطيع API عرض منشورات صفحة أخرى؟
فقط بميزة Page Public Content Access لدى Meta وبرمز وصول مستخدم (User access token). يقرأ easyCoexistence الصفحات التي تربطها، برموز وصول الصفحات الخاصة بها.
كيف أحصل على منشورات من نطاق تاريخي؟
أضف since وuntil إلى القراءة، كطوابع زمنية UNIX أو قيم strtotime؛ ويوصي دليل الترقيم لدى Meta باستخدامهما معًا للحصول على نتائج متسقة.
كم تكلّف easyCoexistence لصفحة فيسبوك؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية لأول 3 أيام؛ كل صفحة مربوطة تُحسب اتصالًا واحدًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في