登入開始免費試用
easyCoexistence 官方 API

透過 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 則。

100

每次請求以 limit 可讀取的貼文數上限;要求更多會返回錯誤。

About 600

API 讀取專頁貼文時,每年返回的經排序已發布貼文數量。

is_published

用以區分已發布與未發布貼文的欄位,而 feed 端點會一併返回兩者。

video_reels

Meta 的 feed 參考所指向、用以列出發布至專頁之 Reels 的專頁端點。

next

需持續跟隨的分頁連結,直至它不再出現;頁面較短或為空,並不代表已到末頁。

posts

專頁自己的貼文,Meta 的專頁參考將其描述為 /feed 端點的衍生內容。

feed、posts 與 published_posts 有何分別?

分別在於貼文由誰撰寫,以及是否已經發布。Meta 的專頁參考以此描述三個主要端點及另外三個較窄的端點,而 feed 亦會返回未發布的貼文,由 is_published 區分:

feedThe Page's feed: its own posts and links, visitors' posts and public posts tagging it
postsThe Page's own posts, a derivative of /feed
published_postsPublished posts by the Page
scheduled_postsPosts the Page scheduled to a future date
visitor_postsPublic posts published by visitors on the Page
taggedPhotos, videos and posts in which the Page is tagged

哪些欄位值得索取?

在 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 指出它可能超過實際返回的留言數,原因是私隱或留言已被刪除。

Reading posts with share and reaction counts
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 的值。
使用 EasyCoexistence 完成這項設定

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 監察

驗證日期