通过 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 版本,已停用的名称现在会返回无效指标错误。其更新日志、已弃用指标页面及 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 统计通过反应、评论、分享等方式与主页帖子产生的互动,可按 day、week 或 days_28 统计;page_media_view 和 page_total_media_view_unique 则分别对观看次数和观看用户数做同样的统计。Meta 已于 2024 年移除 post_engaged_users,因此单个帖子的互动数据由点击、反应、评论和分享构成。
数据有多新,又能追溯到多久以前?
大多数指标每天更新一次,Meta 标有星号的指标(例如 post_clicks)每天更新数次。Meta 为公开主页保留两年的洞察数据,但未发布的主页仅保留 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;只有创建该视频的主页才能获得准确数值。
- 相信空响应中的零值。若没有 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 监控
验证时间