通过 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 获取所连接账户的观看次数、覆盖人数、观看时长和跳过率。
reels_skip_rate 的统计窗口:在 Reel 前 3 秒内跳过它的观看次数所占比例。
plays、clips_replays_count 和 ig_reels_aggregated_all_plays_count 在所有 API 版本中被弃用的时间。
reels_skip_rate、reposts、crossposted_views 和 facebook_views 被加入媒体洞察的时间。
媒体指标数据可能延迟的时长。
Meta 保存媒体指标的时长。
Reel 会返回哪些指标?
这些指标列在 Meta 媒体洞察参考文档中,适用于 media_product_type REELS,可使用 GET /<IG_MEDIA_ID>/insights 并附带以逗号分隔的 metric 参数读取。Meta 将其中若干指标标注为估算值或开发中,标注见各指标旁,并且只将点赞和评论计为自然互动:
Reels 洞察请求会返回什么?
data 中为每个指标返回一个对象,包含 name、period、values、title、description 和 id。period 始终为 lifetime:Meta 为媒体指标设定该值且无法更改,因此请求中无需指定。Meta 参考文档将两个观看时长指标描述为时间长度,但未注明单位,因此在绘制图表前,请先对照一个您熟悉的 Reel 进行核对。
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 年前编写的指标列表需要更新:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
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。
{
"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 返回空数据集。
若某个指标名称已停用,则返回 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 监控
验证时间