登录开始免费试用
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 主页和帖文洞察。

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

Meta 洞察参考文档中的限制之一:Reels 上的互动不计入主页指标。

video_insights 为视频返回哪些指标?

截至 2026 年 11 月,以下视频指标见于 Meta 参考文档,且不在其弃用清单中。它们均为在视频 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。

Page 级指标是否包括 Reels?

否。Meta 洞察参考文档在有关读取主页指标的限制中列出:Reels 上的互动不计入其中。Reel 的播放次数、关注数、评论数和分享数须在 Reel 本身读取,即通过其视频 ID 调用 video_insights。

easyCoexistence 如何读取这些数据?

get_social_insights 读取主页或单条帖文的 insights 边:指定 metrics、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 完成这些操作

您可以从 Claude、ChatGPT 或自有代码中调用,让 AI 说明主页及其帖文的表现;视频或 Reel 自身的 video_insights 需在 Meta Business Suite 中查看。每个连接每月 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 获取,视频 ID 为 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 监控

验证时间