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

透過 API 查看 Facebook Reels 與影片洞察

Facebook 影片與 Reels 洞察來自 GET /{video-id}/video_insights:total_video_views 計算至少 3 秒的播放次數,total_video_avg_time_watched 與 total_video_view_total_time 以毫秒為單位提供觀看時間,而 Reels 另有 blue_reels_play_count、fb_reels_total_plays 與 fb_reels_replay_count。Meta 已於 2026 年 6 月在所有 API 版本中棄用 total_video_impressions 等影片曝光與不重複觀看者指標。

easyCoexistence 透過 get_social_insights 讀取 Facebook 專頁與貼文洞察,可從 Claude、ChatGPT 或你自己的程式使用,讓你的 AI 說明專頁及其貼文的表現;影片或 Reel 本身的 video_insights 則須在 Meta Business Suite 查看。

3 seconds

total_video_views 計入的最短播放時長,若影片短於此時長則接近整段長度。

June 2026

Meta 何時在所有 API 版本中棄用 total_video_impressions、total_video_views_unique 與 post_video_views_unique。

2 years

影片洞察資料可回溯的時間範圍。

40 intervals

total_video_retention_graph 如何切分影片,並以佔全部觀看次數的百分比報告各節點的播放。

1 ms

計入 blue_reels_play_count 的 Reels 播放,不包括重播。

Reels left out

Reels 的互動不計入專頁指標,此為 Meta 洞察參考列明的限制之一。

video_insights 會為影片返回哪些指標?

這些影片指標記載於 Meta 參考文件,截至 2026 年 11 月未列入棄用清單,均為在影片 ID 上讀取的累計總數。「觀看次數」不計入同一次播放中的重播時間,部分指標有自然流量與付費版本,例如 total_video_views_organic 與 total_video_views_paid:

total_video_viewsPlays of at least 3 seconds, or nearly the full length if shorter
total_video_complete_viewsPlays of 97% or more of the length
total_video_15s_viewsPlays of 15 seconds or more
total_video_60s_excludes_shorter_viewsPlays of 60 seconds or more
total_video_avg_time_watchedAverage viewing time, in milliseconds
total_video_view_total_timeTotal viewing time, in milliseconds
total_video_retention_graphPlays at each of 40 intervals, as a percentage of views
total_video_reactions_by_type_totalReactions to the video, by type

哪些指標涵蓋 Reels?

Meta 參考文件設有 Reels 一節,在 Reel 的影片 ID 上讀取,數值均為累計值:

  • blue_reels_play_count:曝光後播放時長達 1 毫秒或以上即計入,不包括重播。
  • fb_reels_total_plays:同一批播放,包括重播;fb_reels_replay_count:僅計同一工作階段內的重播。
  • post_video_avg_time_watched 與 post_video_view_time:平均與總播放毫秒數,包括重播。
  • post_video_followers:來自該 Reel 的追蹤。
  • post_video_likes_by_reaction_type:該 Reel 的按讚數,按反應類型劃分。
  • post_video_social_actions:該 Reel 的留言與分享。
  • post_video_retention_graph:Reel 各時間點的播放次數,佔總播放的百分比。

Meta 在 2026 年棄用了哪些影片指標?

Meta 的 Graph API v25 公告於 2026 年 6 月在所有 API 版本中棄用兩組指標,並建議改用其 Media Views 與 Media Viewers 指標:用於不重複觀看者的 post_total_media_view_unique 與 page_total_media_view_unique,以及用於付費與自然流量分拆的 post_media_view 與 page_media_view。

  • 影片曝光:total_video_impressions 及其不重複、付費、自然、病毒式與粉絲版本,以及貼文影片上的 post_impressions_unique。
  • 3 秒觀看者:total_video_views_unique 及其自然與付費版本、post_video_views_unique 及其自然與付費版本,以及 page_video_views_unique。

post_video_views 與 page_video_views 是否仍然有效?

是。兩者在 Meta 洞察參考文件中均無棄用標記:post_video_views 計算貼文影片至少 3 秒的播放次數,可按累計或按日統計;page_video_views 計算專頁的相應數字,可按日、週或 days_28 統計。其不重複版本 post_video_views_unique 及 page_video_views_unique 已於 2026 年 6 月對所有 API 版本棄用,10 秒指標(例如 post_video_views_10s)則在 v18 或以上版本標記為已棄用。

如何請求影片洞察?

需在三類物件上請求,每類各有其指標。GET /{video-id}/video_insights 搭配以逗號分隔的 metric 清單,可讀取影片或 Reel;若不提供 metric,則返回該影片的總數。貼文層級的影片指標,例如 post_video_views,透過 GET /{page-post-id}/insights 讀取;專頁層級的指標,例如 page_video_views,則透過 GET /{page-id}/insights 並指定 period 讀取。

Reading a video's views and watch time
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graph

需要哪些權限與任務?

需要來自有權在專頁上執行 ANALYZE 任務之人士的專頁存取權杖。Meta 的 video_insights 參考文件列明 read_insights 與 pages_manage_engagement,而其影片洞察指南則列明 pages_read_engagement。資料涵蓋過去 2 年;用戶或群組上的影片洞察無法取得;交叉發布的影片在其發布到的每個專頁上都有獨立的影片 ID。

專頁層級的指標是否包括 Reels?

不包括。Meta 洞察參考文件在讀取專頁指標的限制中列明,Reels 上的互動不計入其中。Reel 的播放、追蹤、留言與分享,須直接在 Reel 本身讀取,即透過其影片 ID 使用 video_insights。

easyCoexistence 如何讀取這些數據?

get_social_insights 讀取專頁或單一貼文的 insights 邊(edge):提供 metric、period,以及貼文的 object_id,並可傳遞 since、until 等額外參數。video_insights 是獨立的邊,沒有任何工具可讀取,因此影片或 Reel 本身的指標須在 Meta Business Suite 查看。已退役的指標會以 Meta 的錯誤形式返回,你的 AI 便可改用新名稱。

常見錯誤

  • 請求 total_video_impressions。Meta 已於 2026 年 6 月棄用影片曝光指標;請改為請求其 Media Views 指標,例如 post_media_view。
  • 將留存曲線數值相加。它們是各區間佔觀看次數的百分比,並非播放次數。
  • 在專頁總數中尋找 Reels。Meta 的專頁洞察不計入 Reels 上的互動,因此應讀取每個 Reel 自身的 video_insights。
  • 將觀看時間誤讀為秒。total_video_avg_time_watched、total_video_view_total_time 與 post_video_view_time 的單位是毫秒。
使用 EasyCoexistence 完成這項設定

每個連接每月由 US$ 9 降至 US$ 0.75,連接越多單價越低,前 3 天免費。

常見問題

total_video_views_unique 已由什麼取代?

Meta 指向其 Media Viewers 指標:貼文上的 post_total_media_view_unique,以及專頁的 page_total_media_view_unique。

如何透過 API 取得 Reel 的播放次數?

讀取 blue_reels_play_count;如需包括重播,則讀取 fb_reels_total_plays。兩者均可透過 GET /{video-id}/video_insights 取得,並使用 Reel 啟動請求所返回的影片 ID。

post_impressions_unique 對 Reels 仍然有效嗎?

無效。Meta 的 Reels 表格仍列出此指標,但 v25 公告已於 2026 年 6 月在 video_insights 上棄用它;post_total_media_view_unique 則計算貼文上的不重複觀看者。

哪些影片沒有洞察數據?

在用戶或群組上發布的影片。Meta 的影片洞察涵蓋專頁上的影片,數據保存過去 2 年。

繼續閱讀

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

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

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

驗證日期