登录开始免费试用
easyCoexistence 官方 API

通过 API 查看 Instagram Reels 洞察数据

Instagram 的媒体洞察端点 GET /<IG_MEDIA_ID>/insights 会为 Reel 返回以下指标:views、reach、likes、comments、shares、saved、reposts、total_interactions、ig_reels_avg_watch_time、ig_reels_video_view_total_time 和 reels_skip_rate;对于已交叉发布的 Reel,还会返回 crossposted_views 和 facebook_views。plays、clips_replays_count 和 ig_reels_aggregated_all_plays_count 已于 2025 年 4 月停用,由 views 取代。

easyCoexistence 通过 get_social_insights 读取 Reel 的洞察数据,因此 Claude、ChatGPT 或您自己的代码可以询问某个 Reel 的表现,并直接从 Meta 获取所连接账户的观看次数、覆盖人数、观看时长和跳过率。

3 seconds

reels_skip_rate 的统计窗口:在 Reel 前 3 秒内跳过它的观看次数所占比例。

21 Apr 2025

plays、clips_replays_count 和 ig_reels_aggregated_all_plays_count 在所有 API 版本中被弃用的时间。

3 Dec 2025

reels_skip_rate、reposts、crossposted_views 和 facebook_views 被加入媒体洞察的时间。

48 hours

媒体指标数据可能延迟的时长。

2 years

Meta 保存媒体指标的时长。

Reel 会返回哪些指标?

这些指标列在 Meta 媒体洞察参考文档中,适用于 media_product_type REELS,可使用 GET /<IG_MEDIA_ID>/insights 并附带以逗号分隔的 metric 参数读取。Meta 将其中若干指标标注为估算值或开发中,标注见各指标旁,并且只将点赞和评论计为自然互动:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

Reels 洞察请求会返回什么?

data 中为每个指标返回一个对象,包含 name、period、values、title、description 和 id。period 始终为 lifetime:Meta 为媒体指标设定该值且无法更改,因此请求中无需指定。Meta 参考文档将两个观看时长指标描述为时间长度,但未注明单位,因此在绘制图表前,请先对照一个您熟悉的 Reel 进行核对。

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

哪些 Reels 指标已停用,替代项是什么?

Meta 于 2025 年 1 月 21 日(即推出 views 当日)起在 Graph API v22.0 中弃用前三个指标,并于 2025 年 4 月 21 日起在所有版本中弃用;video_views 自 v21.0 起弃用,并于 2025 年 1 月 8 日起在所有版本中弃用。请求已停用的指标会失败,因此 2025 年前编写的指标列表需要更新:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

views 和 reach 在 Reel 上统计什么?

views 是该 Reel 在 Instagram 上被播放的次数,Meta 将其标注为开发中;reach 是至少看过一次该 Reel 的不同账户数,Meta 将其标注为估算值。likes、comments、views 和 total_interactions 仅统计自然互动,不包含基于该 Reel 投放的广告所产生的互动。total_likes、total_comments 和 total_views 包含推广内容,仅通过 Facebook Login 提供。

有哪些限制和延迟?

Meta 的媒体洞察参考文档对 Reel 的数据设置了以下规则:

  • 指标背后的数据可能延迟最多 48 小时。
  • 媒体指标最多保存 2 年。
  • 数据缺失或不可用时,返回空数据集,而不是 0。
  • crossposted_views 和 facebook_views 对未交叉发布的 Reel 会报错,因此请在单独的调用中请求它们。
  • 若某个请求的指标不支持所要求的细分,整个请求会失败,并返回“An unknown error has occurred.”。
  • 使用 Instagram Login 时,访问令牌需要 instagram_business_basic 和 instagram_business_manage_insights 权限,并使用 graph.instagram.com。

get_social_insights 如何读取一个 Reel?

使用连接的 account_id、Reel 的媒体 ID 作为 object_id,以及指标列表进行调用。easyCoexistence 会使用该账户的访问令牌,在 graph.instagram.com 上调用 GET /<IG_MEDIA_ID>/insights,将指标名称原样传给 Meta,并返回 Meta 的数据;若某个名称已停用,则返回 Meta 自身的错误。list_social_posts 返回该账户近期帖子和 Reels 的媒体 ID。

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

常见错误

  • 请求 plays 或 clips_replays_count。两者已于 2025 年 4 月 21 日在所有 API 版本中弃用;请改为请求 views。
  • 将 crossposted_views 或 facebook_views 混入通用请求。对未交叉发布的 Reel,它们会报错,该错误会导致整个调用失败。
  • 假设观看时长有单位。Meta 参考文档未为 ig_reels_avg_watch_time 或 ig_reels_video_view_total_time 注明单位,因此请对照一个已知 Reel 进行核对。
  • 把空结果当作零。当数据不存在或当前不可用时,Meta 返回空数据集。
使用 EasyCoexistence 完成这些操作

若某个指标名称已停用,则返回 Meta 自身的错误。每个连接每月 US$ 9 至 US$ 0.75,连接越多价格越低,前 3 天免费试用。

常见问题

为什么 Reels 洞察请求返回空结果?

当数据不存在或当前不可用时,Meta 返回空数据集,而不是 0;指标背后的数据可能滞后最多 48 小时。

如何通过 API 获取 Reels 观看时长?

请求 ig_reels_avg_watch_time 获取平均值,请求 ig_reels_video_view_total_time 获取总值(包括重播在内),均来自 GET /<IG_MEDIA_ID>/insights。

reels_skip_rate 是什么?

它是在 Reel 前 3 秒内跳过该 Reel 的初始观看次数所占的百分比。Meta 于 2025 年 12 月 3 日新增该指标,并将其标注为估算值和开发中。

Reels 洞察是否包括广告观看?

不包括。likes、comments、views 和 total_interactions 仅统计自然互动;包含推广内容的 total_views 仅通过 Facebook Login 提供。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间