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

通过 API 获取 Instagram Story 洞察数据

Instagram 的媒体洞察端点会在 Story 发布期间返回以下指标:reach、views、replies、shares、navigation、follows、profile_visits、profile_activity、reposts 和 total_interactions。navigation 通过 story_navigation_action_type 细分为 TAP_FORWARD、TAP_BACK、TAP_EXIT 和 SWIPE_FORWARD。Story 指标仅可获取 24 小时,数值低于 5 时返回错误 10,并且 Instagram Login 没有 story_insights Webhook。

EasyCoexistence 在 Story 发布期间通过 get_social_insights 读取其洞察数据,因此 Claude、ChatGPT 或您自己的代码可以询问今天的 Story 表现如何,并直接从 Meta 获取已连接账户的触达、观看、回复、分享和导航数据。

24 hours

Story 媒体指标通过 API 可用的时长。

Error 10

当 Story 指标低于 5 时返回此内容,表示观看人数不足,媒体无法显示洞察数据。

Facebook Login

Meta 洞察指南中唯一给出的 story_insights Webhook 设置方法;Instagram Login 不支持该 Webhook。

0

欧洲或日本账户所创建 Story 的 replies 数值。

22 Jun 2026

Meta 为 Story 新增 link_clicks 的时间,用于统计对链接(例如链接贴纸)的点按次数,仅适用于 Facebook Login。

Story 会返回哪些指标?

这些指标列在 Meta 的媒体洞察参考文档中,适用于 media_product_type 为 STORY 的媒体。在 Story 发布期间,使用 GET /<STORY_MEDIA_ID>/insights 读取。使用 Instagram Login 时,请求发送至 graph.instagram.com,访问令牌需包含 instagram_business_basic 和 instagram_business_manage_insights,且 period 始终为 lifetime:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

如何按操作读取 navigation?

单独请求 navigation,并设置 breakdown=story_navigation_action_type。总数返回在 total_value.value 中,每个操作返回在 total_value.breakdowns[].results 中,这些值相加等于总数:TAP_FORWARD(前进)、TAP_BACK(后退)、TAP_EXIT(退出)和 SWIPE_FORWARD(下一 Story)。Meta 的示例响应将数值写为小写:

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": ["story_navigation_action_type"],
            "results": [
              { "dimension_values": ["tap_forward"], "value": 19 },
              { "dimension_values": ["tap_back"], "value": 4 },
              { "dimension_values": ["tap_exit"], "value": 1 },
              { "dimension_values": ["swipe_forward"], "value": 1 }
            ]
          }
        ]
      },
      "id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

Story 指标可获取多长时间?

24 小时。Meta 仅在 24 小时内提供 Story 媒体指标,即 Story 自身的生命周期,而底层数据可能滞后最多 48 小时。请在 Story 发布期间按计划读取,并保留最后一次获取的数值。Meta 指出,如果 Story 被添加到精选,数据可能在 Story 过期后仍会陆续返回,此时 API 调用、Webhook 和应用可能显示不同的结果。

为什么某个 Story 指标返回错误 10?

因为其数值低于 5。Meta 会返回错误代码 10,并附带消息 (#10) Not enough viewers for the media to show insights,而不是一个小数字,因此观看人数少的 Story 可能失败,而观看人数多的则可能成功。请将其视为低计数而非故障,不要循环重试。

为什么 Story 的 replies 为 0?

这是地区规则造成的。自 2020 年 12 月 1 日起,来自欧洲的回复,以及自 2021 年 4 月 14 日起,来自日本的回复,不计入 replies 指标,因此由这些地区账户创建的 Story 会返回 0。Meta 的参考文档将 replies 定义为该 Story 媒体对象上的 IG Comments。

是否存在 story_insights Webhook?

使用 Instagram Login 时不存在。Meta 的字段表将 story_insights 标记为在该登录方式下不可用,其媒体洞察参考文档指出 Instagram Login 不支持洞察 Webhook,其洞察指南则仅将 story_insights 列为 Facebook Login 专用。使用 Facebook Login 时,该字段在 Story 过期时触发,仅包含前 24 小时的指标,且低于 5 的计数返回 -1。

哪些 Story 指标已停用或受限?

以下名称仍可能出现在旧代码或 Meta 的更新日志中:

  • impressions:自 2024 年 7 月 2 日起创建的媒体已弃用,因此当前 Story 改为返回 views。
  • taps_forward、taps_back 和 exits:已于 2023 年 12 月 11 日停用;按 story_navigation_action_type 细分的 navigation 返回相同的操作。
  • link_clicks:对链接(例如链接贴纸)的点按次数,于 2026 年 6 月 22 日新增,仅适用于 Facebook Login。
  • total_views:跨平台的观看次数,包括推广媒体,仅适用于 Facebook Login。

get_social_insights 如何读取 Story?

以 Story 的媒体 ID 作为 object_id,该 ID 由 publish_instagram_post 在发布 Story 时以 media_id 返回,指标则以列表形式返回。请在单独的调用中请求 navigation,并将 params 设为 breakdown story_navigation_action_type,因为只要有一个所请求的指标不支持该 breakdown,整个调用都会失败。Meta 的错误(包括错误 10)按 Meta 原文返回。

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

常见错误

  • 第二天再读取 Story 的指标。Meta 仅在 24 小时内提供这些指标,因此请在 Story 发布期间收集。
  • 循环重试错误 10。它表示数值低于 5,即观看人数不足,在更多人看到该 Story 之前不会改变。
  • 在请求其他指标的同时请求带 breakdown 的 navigation。story_navigation_action_type 仅适用于 navigation,不受支持的 breakdown 会导致整个调用失败。
  • 在 Instagram Login 下等待 story_insights。Meta 在该登录方式下不提供此 Webhook,因此请在 Story 过期之前轮询洞察端点。
使用 EasyCoexistence 完成这些操作

Story 通过 publish_instagram_post 发布。每个连接每月 US$ 9 至 US$ 0.75,随连接数增加而降低,前 3 天免费试用。

常见问题

Story 加入精选后,洞察数据会改变吗?

可能会改变。Meta 表示,加入精选的 Story 在过期后可能仍会持续接收数据,因此在一段时间内,API、Webhook 和应用之间的结果可能不一致。

total_views 能用于 Instagram Login 下的 Story 吗?

不能。total_views 统计跨平台的观看次数,包括推广媒体,仅适用于 Facebook Login;使用 Instagram Login 时,请改为请求 views。

API 能读取 Instagram Story 上的链接贴纸点击数吗?

仅限 Facebook Login。Meta 于 2026 年 6 月 22 日为 Story 新增 link_clicks,用于统计链接(例如链接贴纸)的点按次数,且不向 Instagram Login 提供。

什么取代了 taps_forward、taps_back 和 exits?

按 story_navigation_action_type 细分为 TAP_FORWARD、TAP_BACK、TAP_EXIT 和 SWIPE_FORWARD 的 navigation。旧指标已于 2023 年 12 月 11 日停用。

继续阅读

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

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

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

验证时间