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

透過 API 查看 Facebook 貼文洞察:瀏覽次數、覆蓋人數與互動

Facebook 貼文洞察來自 GET /{page-post-id}/insights,可指定 post_media_view(貼文被播放或顯示的次數)、post_total_media_view_unique(獨立瀏覽人數)、post_clicks、post_reactions_by_type_total 等指標。Meta 已於 2025 年 11 月棄用 post_impressions,並於 2026 年 6 月棄用 post_impressions_unique,因此現時以瀏覽次數與獨立瀏覽人數代替曝光與覆蓋人數。

easyCoexistence 透過 get_social_insights 讀取 Facebook 貼文洞察,讓 Claude、ChatGPT 或你自己的程式查詢貼文表現,並取回 Meta 現時的瀏覽次數、獨立瀏覽人數、點擊與回應數;再以 list_social_posts 找出貼文。

post_total_media_view_unique

Meta 建議的 post_impressions_unique 替代指標,並已將其於所有 API 版本的棄用日期定為 2026 年 6 月。

15 Nov 2025

post_impressions 在所有版本停止回傳數據的時間點;Meta 指定 post_media_view 為替代指標。

lifetime

Meta 為 post_media_view、post_clicks 及回應總數等貼文指標列明的期間。

Like + care

Meta 的「讚好」回應數同時包括「讚好」與「關心」兩類回應。

Empty dataset

應用程式缺少 read_insights 權限時,Meta 所回傳的結果(而非錯誤)。

2026 年有哪些貼文指標仍然有效?

以下指標載於 Meta 的洞察參考文件,截至 2026 年 11 月 1 日未列入棄用清單。每項均以貼文 ID 讀取,除另有註明外,期間為 lifetime:

  • post_media_view:貼文被播放或顯示的次數,附 is_from_ads 與 is_from_followers 分項。
  • post_total_media_view_unique:貼文的獨立瀏覽人數,是 Meta 用來代替覆蓋人數的指標。
  • post_clicks:貼文中未產生動態的任何位置點擊次數;post_clicks_by_type 按內容類型細分。
  • post_reactions_by_type_total:按類型列出的回應數,每類另有一個總數,例如 post_reactions_love_total 或 post_reactions_anger_total。
  • post_video_views:影片播放至少 3 秒的次數,期間可選 lifetime 或 day。

什麼取代了貼文曝光與覆蓋人數?

Meta 分兩輪將貼文量度由曝光轉為媒體瀏覽,每輪均同時適用於所有 API 版本;已退役的指標名稱現時會回傳無效指標錯誤。Meta 的更新日誌、棄用指標頁面及 Graph API v25 說明列出以下替代指標:

DeprecatedUse instead
Nov 15, 2025post_impressionspost_media_view
Nov 15, 2025post_impressions_paidpost_media_view with is_from_ads
Nov 15, 2025post_impressions_fanpost_media_view with is_from_followers
June 2026post_impressions_uniquepost_total_media_view_unique
June 2026post_impressions_paid_unique, post_impressions_organic_uniquepost_media_view breakdowns, which count views rather than people

瀏覽次數與獨立瀏覽人數有何分別?

瀏覽次數計算顯示次數,獨立瀏覽人數計算人數。post_media_view 累計每次貼文被播放或顯示的次數,因此同一人看到兩次便計算兩次;post_total_media_view_unique 則將貼文的每位獨立瀏覽者只計一次。Meta 將以 _unique 結尾的指標標示為約略數值,並獨立計算獨立值,因此總數未必等於各部分之和。

如何請求貼文的洞察數據?

使用 GET /{page-post-id}/insights,並將 metric 設為以逗號分隔的指標清單;如只需一項,則使用 GET /{page-post-id}/insights/{metric}。存取權杖須由能在專頁上執行 ANALYZE 任務的人員取得,並已授予 read_insights 與 pages_read_engagement 權限。每項結果均包含 name、period、values、title 與 description。Meta 的官方範例要求回應總數:

Meta's example request and response for one post, trimmed
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total

{
  "data": [
    {
      "name": "post_reactions_like_total",
      "period": "lifetime",
      "values": [{ "value": 226 }],
      "title": "Lifetime Total Like Reactions of a post.",
      "id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
    },
    {
      "name": "post_reactions_love_total",
      "period": "lifetime",
      "values": [{ "value": 17 }],
      "title": "Lifetime Total Love Reactions of a post.",
      "id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
    }
  ]
}

如何統計回應、留言與分享?

從貼文本身的欄位取得,與洞察數據分開。fields=reactions.summary(total_count) 回傳回應總數,reactions.type(LOVE).limit(0).summary(total_count) 回傳單一類型的數目,類型可為 LIKE、LOVE、WOW、HAHA、SORRY 或 ANGRY。shares 欄位為分享數,Meta 表示此數字可能包括已刪除的貼文,以及存取權杖無法看到的貼文;另外,加上 summary=true 的 comments 邊緣會附加 total_count。

貼文指標與專頁指標有何關係?

專頁指標是統計專頁內容在某段期間的總和,貼文指標則是單篇貼文的累計總數。page_post_engagements 按日、週或 days_28 統計用戶對專頁貼文的互動,包括回應、留言、分享等;page_media_view 與 page_total_media_view_unique 則分別統計瀏覽次數與瀏覽人數。Meta 已於 2024 年移除 post_engaged_users,因此每篇貼文的互動數,是由點擊、回應、留言與分享組合而成。

數據多久更新一次,可追溯多久?

大部分指標每日更新一次;Meta 標示星號的指標(例如 post_clicks)則每日更新數次。公開專頁的洞察數據保留兩年,未發布的專頁則只保留 5 天。lifetime 指可提供數據的期間,預設為兩年或更短。專頁的讚好數須達 100 或以上才有專頁洞察數據,而若影片是從其他專頁轉發,多項影片指標會顯示 0。

easyCoexistence 如何讀取貼文洞察?

get_social_insights 接受指標清單;若指定單篇貼文,則需提供 object_id,即 list_social_posts 回傳的貼文 ID;若不提供 object_id,則讀取專頁。period 及 since、until 等額外參數會原樣傳送至 Meta。已退役的指標會回傳 Meta 的無效指標錯誤,讓 AI 可改用現時的名稱。

常見錯誤

  • 請求 post_impressions_unique。Meta 已於 2026 年 6 月於所有 API 版本棄用此指標;如要計算獨立瀏覽人數,請改用 post_total_media_view_unique。
  • 將多篇貼文的獨立瀏覽人數相加。每篇貼文各自計算其瀏覽者(約略數值),因此看過兩篇貼文的人會被計算兩次。
  • 讀取其他專頁轉發影片的洞察數據。多項影片指標對轉發內容回傳 0;只有建立該影片的專頁才會獲得準確數值。
  • 相信空白回應中的 0。若缺少 read_insights 權限,Meta 會回傳空數據集而非錯誤,因此應先檢查權限。
使用 EasyCoexistence 完成這項設定

每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並設有 3 天免費試用。

常見問題

Facebook 上的貼文覆蓋人數由什麼取代?

post_total_media_view_unique,即貼文的獨立瀏覽人數。Meta 已於 2026 年 6 月棄用 post_impressions_unique。

我能看到誰對專頁貼文作出回應嗎?

不能。Meta 回傳各類型回應的數目,但專頁或個人只能查詢自己的回應,其他人的回應保持私隱。

讚好數是否包括關心回應?

包括。Meta 的讚好總數同時計入讚好與關心,無論是在洞察數據還是 reactions 邊緣中皆如此。

我能讀取另一個專頁上貼文的洞察數據嗎?

不能透過專頁洞察讀取。該數據需要由能在建立該貼文的專頁上執行 ANALYZE 任務的人員所提供的存取權杖。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期