הצגת הפוסטים של עמוד פייסבוק דרך ה-API: feed, posts, published_posts
פוסטים של עמוד פייסבוק נקראים משלוש נקודות קצה ב-Graph API. נקודת הקצה /{page-id}/feed מחזירה את הפיד של העמוד, כולל פוסטים של גולשים ופוסטים ציבוריים שמתייגים את העמוד. נקודת הקצה /{page-id}/posts מחזירה את הפוסטים של העמוד עצמו, ונקודת הקצה /{page-id}/published_posts מחזירה את הפוסטים שפורסמו. בקשה אחת מחזירה עד 100 פוסטים, העמודים הבאים מגיעים לפי cursor, ו-Meta מחזירה כ-600 פוסטים מדורגים ומפורסמים בשנה.
easyCoexistence מציג את הפוסטים האחרונים של עמוד פייסבוק בעזרת list_social_posts מ-Claude, מ-ChatGPT או מהקוד שלכם, עד 100 בכל קריאה.
מספר הפוסטים המרבי שבקשה אחת יכולה לקרוא עם limit; בקשה לכמות גדולה יותר מחזירה שגיאה.
מספר הפוסטים המדורגים והמפורסמים בשנה שה-API מחזיר בקריאת הפוסטים של עמוד.
השדה is_published מבחין בין פוסטים שפורסמו לאלה שלא, וקצה feed מחזיר את שניהם יחד.
קצה העמוד שאליו מפנה מסמך ההפניה של Meta לקצה feed, לרשימת ה-Reels שפורסמו בעמוד.
קישור הדפדוף שיש לעקוב אחריו עד שהוא נעלם; עמוד קצר או ריק אינו מסמן את הסוף.
הפוסטים של העמוד עצמו, שמסמך ההפניה של Meta לעמוד מתאר כנגזרת של נקודת הקצה /feed.
מה ההבדל בין feed, posts, published_posts?
מי כתב את הפוסט והאם הוא כבר פורסם. מסמך ההפניה של Meta לעמוד מתאר את שלושת הקצוות המרכזיים ואת שלושה קצוות צרים יותר בדיוק כך. הפיד מחזיר גם פוסטים שטרם פורסמו לצד הפוסטים שפורסמו, והשדה is_published מבחין ביניהם:
אילו שדות כדאי לבקש?
מציינים אותם בפרמטר fields. הקריאה לדוגמה של Meta לפוסטים של עמוד מחזירה את השדות: id, created_time, message. מסמך ה-Page Post שלה מונה את השדות האלה בין השדות של פוסט:
- 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איך עובד הדפדוף?
לפי cursor. כל תגובה נושאת את paging, שכולל cursors לפני ואחרי, וקישורים בשם next ובשם previous. יש לעקוב אחרי next עד שהוא נעלם. Meta מזהירה לא להתייחס לעמוד שמכיל פחות תוצאות מ-limit כאל הסוף, שכן עמוד יכול להיות אפילו ריק ועדיין לכלול next. cursors עלולים להפוך במהירות ללא תקפים כשפריטים מתווספים או נמחקים, ולכן לטווח שאליו חוזרים יש להשתמש ב-since וב-until.
אילו מגבלות חלות?
מסמך ההפניה של Meta לקצה feed קובע את אלה לקריאת פוסטים של עמוד:
- 100 פוסטים בבקשה עם limit; ערך גבוה יותר מחזיר שגיאה שמבקשת לא לחרוג מ-100.
- כ-600 פוסטים מדורגים ומפורסמים בשנה.
- תוכן של פוסט שפג תוקפו כבר לא ניתן לצפייה דרך Graph API.
- קריאת פוסטי וידאו דורשת שהמבקש יהיה מנהל של העמוד.
- פוסט ששיתף פוסט של מישהו אחר עשוי להיות לא גלוי אם המקור אינו גלוי לאסימון שבשימוש.
- פרטי אנשים מופיעים בתגובות רק כשהבקשה משתמשת באסימון גישה של עמוד.
איפה מופיעים ה-Reels וה-Stories?
בקצוות משלהם. מסמך ההפניה של Meta לקצה feed מפנה לקצה video_reels של העמוד עבור ה-Reels שפורסמו בעמוד. קריאת GET אל /{page-id}/video_reels מציגה אותם עם since וגם until. קריאת GET אל /{page-id}/stories מציגה את ה-Stories של העמוד כ-PUBLISHED או כ-ARCHIVED, והארכיוניים רק כשארכיון ה-Stories של העמוד פועל.
מה list_social_posts מחזיר לעמוד?
הכלי מחזיר את הפוסטים האחרונים של העמוד מנקודת הקצה /{page-id}/posts: 25 כברירת מחדל ועד 100 בכל קריאה. כל פוסט כולל את השדות id, message, created_time, permalink_url, full_picture, וכן את cursors הדפדוף של Meta. הכלי אינו מבקש ספירות וקורא דף תוצאות אחד: list_social_comments קורא את התגובות של פוסט, ו-get_social_insights קורא את המדדים של פוסט כשהמזהה שלו הוא object_id.
איך מציגים את הפוסטים שנוצרו דרך easyCoexistence?
בעזרת list_scheduled_posts, שמציג את הפוסטים שנוצרו דרך easyCoexistence, שפורסמו עכשיו או מתוזמנים: הקרובים ביותר קודם, לפי סטטוס, או לפי post_id בודד. לכל פוסט יש סטטוס (scheduled, publishing, processing, published, failed או canceled), publish_at, הקישור שלו אחרי שעלה, ואת השגיאה אם נכשל. במסך הפוסטים של לוח הבקרה הם מופיעים תחת Needs attention, Coming up וגם Published.
טעויות נפוצות
- ציפייה לספירות מ-list_social_posts. הכלי קורא טקסט, זמן, קישור ותמונה; המדדים של פוסט מגיעים מ-get_social_insights כשהמזהה שלו הוא object_id.
- קריאה מהקצה /feed כדי לקבל את הפוסטים של העמוד עצמו. הקצה מחזיר גם פוסטים של גולשים, פוסטים ציבוריים שמתייגים את העמוד ופוסטים שלא פורסמו; השתמשו בקצה /published_posts או סננו לפי is_published.
- טיפול בעמוד קצר כעמוד האחרון. עוצרים רק כשהקישור next נעלם, שכן Meta אומרת שעמוד יכול להיות ריק ועדיין לכלול next.
- שמירת cursors לשימוש מאוחר. Meta אומרת שהם עלולים להפוך במהירות ללא תקפים כשפוסטים מתווספים או נמחקים; שמרו במקום זאת את ערכי since וגם until.
list_scheduled_posts עוקב אחרי מה שיצא דרך easyCoexistence. US$ 9 עד US$ 0.75 לחיבור לחודש, שיורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם הקצה feed כולל פוסטים מתוזמנים?
הוא מחזיר פוסטים שפורסמו ושלא פורסמו יחד, לכן יש לקרוא את is_published כדי להבחין ביניהם, או לקרוא את /{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 או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-