登入開始免費試用
easyCoexistence 官方 API

透過 API 查看 Instagram 限時動態數據

Instagram 的媒體洞察端點會在限時動態播放期間回傳以下指標: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。限時動態指標只提供 24 小時,數值低於 5 時會回傳錯誤 10,而 Instagram Login 沒有 story_insights webhook。

easyCoexistence 會在限時動態播放期間,透過 get_social_insights 讀取其洞察數據,讓 Claude、ChatGPT 或您自己的程式碼,都能直接從 Meta 取得已連接帳戶的今日限時動態表現,包括覆蓋、瀏覽、回覆、分享與導航。

24 hours

限時動態媒體指標可透過 API 取得的時間。

Error 10

指標數值低於 5 時,改為回傳此錯誤,因為觀看人數不足,媒體無法顯示洞察數據。

Facebook Login

Meta 洞察指南列出的 story_insights webhook 唯一設定方式;Instagram Login 不支援此功能。

0

由歐洲或日本帳戶建立的限時動態,其 replies 數值。

22 Jun 2026

Meta 新增 link_clicks 指標,用於統計限時動態上的連結點擊,例如連結貼圖;僅適用於 Facebook Login。

限時動態會回傳哪些指標?

在限時動態播放期間,這些指標會列於 Meta 的媒體洞察參考中,適用於 media_product_type 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,並設定 breakdown=story_navigation_action_type。總計會在 total_value.value 回傳,各項動作則列於 total_value.breakdowns[].results,加總後即為總計:TAP_FORWARD(向前)、TAP_BACK(向後)、TAP_EXIT(退出)與 SWIPE_FORWARD(下一則限時動態)。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"
    }
  ]
}

限時動態指標可保留多久?

24 小時。Meta 只會在限時動態的存續期間,即 24 小時內提供其媒體指標,但背後的數據最多可能延遲 48 小時。請在限時動態播放期間定時讀取,並保留最後取得的數值。Meta 提醒,若限時動態加入精選動態,過期後數據仍可能陸續到達,屆時 API 呼叫、webhook 與應用程式的結果可能不一致。

為何限時動態指標會回傳錯誤 10?

因為該數值低於 5。Meta 會回傳錯誤代碼 10 及訊息 (#10) Not enough viewers for the media to show insights,而非一個小數字,因此觀看人數較少的限時動態可能失敗,較熱門的則能成功。請把它視為觀看人數偏低,而非服務中斷,切勿以迴圈重試。

為何限時動態的回覆數為 0?

這是地區規則所致。自 2020 年 12 月 1 日起,歐洲用戶的回覆,以及自 2021 年 4 月 14 日起,日本用戶的回覆,不會計入 replies 指標;因此由這些地區帳戶建立的限時動態會回傳 0。Meta 的參考資料將 replies 定義為限時動態媒體物件上的 IG Comments。

是否有 story_insights webhook?

使用 Instagram Login 時沒有。Meta 的欄位表將 story_insights 標示為此處不可用,其媒體洞察參考亦指出 Instagram Login 不支援洞察 webhook,而其洞察指南只把 story_insights 列為 Facebook Login 專用。使用 Facebook Login 時,此欄位會在限時動態過期時觸發,只包含首 24 小時的指標,並以 -1 回傳低於 5 的數值。

哪些限時動態指標已停用或受限?

舊程式碼或 Meta 的更新日誌中仍可能出現以下名稱:

  • impressions:適用於 2024 年 7 月 2 日後建立的媒體已停用,因此現時的限時動態會改為回報 views。
  • taps_forward、taps_back 與 exits:已於 2023 年 12 月 11 日停用;navigation 按 story_navigation_action_type 細分後,會回報相同動作。
  • link_clicks:統計連結貼圖等連結的點擊,於 2026 年 6 月 22 日新增,僅適用於 Facebook Login。
  • total_views:跨平台瀏覽次數,包括推廣媒體,僅透過 Facebook Login 提供。

get_social_insights 如何讀取限時動態?

以限時動態的媒體 ID 作為 object_id,該 ID 即 publish_instagram_post 發布限時動態時回傳的 media_id,指標則以列表形式回傳。請把 navigation 另外以獨立呼叫請求,並將 params 設為 breakdown story_navigation_action_type,因為若單一指標不支援該細分,整個呼叫都會失敗。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"]
}

常見錯誤

  • 隔天才讀取限時動態數據。Meta 只會在 24 小時內提供指標,因此須於限時動態播放期間收集。
  • 以迴圈重試錯誤 10。這代表數值低於 5、觀看人數不足,在更多人看到該限時動態前不會改變。
  • 在導航指標旁加入細分請求。story_navigation_action_type 只適用於 navigation,不支援的細分會令整個呼叫失敗。
  • 在 Instagram Login 下等待 story_insights。Meta 在此不提供該 webhook,因此須在限時動態過期前輪詢洞察端點。
使用 EasyCoexistence 完成這項設定

限時動態可透過 publish_instagram_post 發布。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。

常見問題

精選動態會改變限時動態的洞察數據嗎?

會。Meta 表示,加入精選動態的限時動態在過期後仍可能持續收到數據,因此 API、webhook 與應用程式在一段時間內可能出現不一致。

使用 Instagram Login 時,total_views 適用於限時動態嗎?

不適用。total_views 會統計跨平台瀏覽次數(包括推廣媒體),只透過 Facebook Login 提供;使用 Instagram Login 時,請改為請求 views。

API 能否讀取 Instagram 限時動態的連結貼圖點擊?

只能透過 Facebook Login。Meta 於 2026 年 6 月 22 日為限時動態新增 link_clicks,統計連結貼圖等連結的點擊,但 Instagram Login 不提供此功能。

taps_forward、taps_back 與 exits 的替代指標是什麼?

navigation,並按 story_navigation_action_type 細分為 TAP_FORWARD、TAP_BACK、TAP_EXIT 與 SWIPE_FORWARD。舊指標已於 2023 年 12 月 11 日停用。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期