登录开始免费试用
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 版本,已停用的名称现在会返回无效指标错误。其更新日志、已弃用指标页面及 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 统计通过反应、评论、分享等方式与主页帖子产生的互动,可按 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 返回的是空数据集而非错误,因此应先检查权限。
使用 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 监控

验证时间