透過 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 找出貼文。
Meta 建議的 post_impressions_unique 替代指標,並已將其於所有 API 版本的棄用日期定為 2026 年 6 月。
post_impressions 在所有版本停止回傳數據的時間點;Meta 指定 post_media_view 為替代指標。
Meta 為 post_media_view、post_clicks 及回應總數等貼文指標列明的期間。
Meta 的「讚好」回應數同時包括「讚好」與「關心」兩類回應。
應用程式缺少 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 說明列出以下替代指標:
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | post_impressions | post_media_view |
| Nov 15, 2025 | post_impressions_paid | post_media_view with is_from_ads |
| Nov 15, 2025 | post_impressions_fan | post_media_view with is_from_followers |
| June 2026 | post_impressions_unique | post_total_media_view_unique |
| June 2026 | post_impressions_paid_unique, post_impressions_organic_unique | post_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 的官方範例要求回應總數:
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 會回傳空數據集而非錯誤,因此應先檢查權限。
每個連接每月 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 監察
驗證日期