透過 Graph API 列出 Facebook 專頁貼文:feed、posts 與 published_posts
Facebook 專頁的貼文可從三個 Graph API 端點讀取:/{page-id}/feed 返回專頁的動態消息,包括訪客貼文及標記該專頁的公開貼文;/{page-id}/posts 返回專頁自己的貼文;/{page-id}/published_posts 返回已發布的貼文。每次請求最多返回 100 則貼文,之後的頁面以游標取得,Meta 每年約返回 600 則經排序的已發布貼文。
easyCoexistence 可透過 Claude、ChatGPT 或你自己的程式碼,以 list_social_posts 列出 Facebook 專頁的近期貼文,每次最多 100 則。
每次請求以 limit 可讀取的貼文數上限;要求更多會返回錯誤。
API 讀取專頁貼文時,每年返回的經排序已發布貼文數量。
用以區分已發布與未發布貼文的欄位,而 feed 端點會一併返回兩者。
Meta 的 feed 參考所指向、用以列出發布至專頁之 Reels 的專頁端點。
需持續跟隨的分頁連結,直至它不再出現;頁面較短或為空,並不代表已到末頁。
專頁自己的貼文,Meta 的專頁參考將其描述為 /feed 端點的衍生內容。
feed、posts 與 published_posts 有何分別?
分別在於貼文由誰撰寫,以及是否已經發布。Meta 的專頁參考以此描述三個主要端點及另外三個較窄的端點,而 feed 亦會返回未發布的貼文,由 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 註明讚好數包括「在意」反應。shares 自帶數目。當要求 summary 時,comments 端點會返回 total_count,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。
適用哪些限制?
Meta 的 feed 參考為讀取專頁貼文設下以下限制:
- 以 limit 每次請求最多 100 則貼文;較大的值會返回錯誤,要求不得超過 100。
- 每年約 600 則經排序的已發布貼文。
- 已過期貼文的內容無法再透過 Graph API 檢視。
- 列出影片貼文,發出請求的人必須是專頁的管理員。
- 分享他人貼文時,若原帖對所用權杖不可見,該貼文可能無法被看見。
- 只有在請求使用專頁存取權杖時,回應中才會出現用戶的資料。
Reels 與限時動態在哪裡列出?
在各自的獨立端點。Meta 的 feed 參考指向專頁的 video_reels 端點,用以列出發布至專頁的 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 以其 ID 作為 object_id 讀取。
如何列出透過 easyCoexistence 發出的貼文?
使用 list_scheduled_posts 列出透過 easyCoexistence 發出的貼文,無論是即時發布或已排程:即將發布的貼文按最快者排先,亦可按狀態篩選,或以 post_id 查詢單一則。每則貼文附有狀態(scheduled、publishing、processing、published、failed 或 canceled)、publish_at、發布後的連結,以及失敗時的錯誤。控制台的「貼文」畫面會將它們分為「需要處理」、「即將發布」及「已發布」。
常見錯誤
- 以 list_social_posts 期望取得計數。它讀取文字、時間、連結及圖片;貼文的指標須透過 get_social_insights,並以其 ID 作為 object_id 取得。
- 用 /feed 讀取專頁自己的貼文。它也會返回訪客貼文、標記專頁的公開貼文及未發布的貼文;應改用 /published_posts,或依 is_published 篩選。
- 把較短的頁面當作最後一頁。只有在 next 連結消失時才停止,因為 Meta 指出頁面可以為空,卻仍附有一個 next。
- 保存游標以備日後使用。Meta 指出游標會因貼文被增加或刪除而迅速失效;應改為保存 since 及 until 的值。
list_scheduled_posts 會追蹤透過 easyCoexistence 發出的內容。每個連接每月 US$ 9 至 US$ 0.75,連接數量越多,單價越低,首 3 天免費。
常見問題
動態消息端點是否包括已排程的貼文?
它會同時返回已發布及未發布的貼文,因此請讀取 is_published 以作區分;若要取得稍後才發布的貼文,請使用 GET /{page-id}/scheduled_posts。
API 能否列出其他專頁的貼文?
只有在 Meta 的 Page Public Content Access 功能及用戶存取權杖下才可以。easyCoexistence 會以你所連接專頁各自的專頁存取權杖讀取該些專頁。
如何取得某個日期範圍內的貼文?
在讀取時加入 since 及 until,可以是 UNIX 時間戳或 strtotime 值;Meta 的分頁指南建議兩者並用,以取得一致的結果。
easyCoexistence 對 Facebook 專頁的收費是多少?
每個連接每月 US$ 9 至 US$ 0.75,連接數量越多,單價越低,首 3 天免費;每個已連接的專頁即為一個連接。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期