透過 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 取得已連接帳戶的今日限時動態表現,包括覆蓋、瀏覽、回覆、分享與導航。
限時動態媒體指標可透過 API 取得的時間。
指標數值低於 5 時,改為回傳此錯誤,因為觀看人數不足,媒體無法顯示洞察數據。
Meta 洞察指南列出的 story_insights webhook 唯一設定方式;Instagram Login 不支援此功能。
由歐洲或日本帳戶建立的限時動態,其 replies 數值。
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:
如何按動作讀取導航數據?
單獨請求 navigation,並設定 breakdown=story_navigation_action_type。總計會在 total_value.value 回傳,各項動作則列於 total_value.breakdowns[].results,加總後即為總計:TAP_FORWARD(向前)、TAP_BACK(向後)、TAP_EXIT(退出)與 SWIPE_FORWARD(下一則限時動態)。Meta 的範例回應以小寫列出數值:
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 的原文回傳。
{
"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,因此須在限時動態過期前輪詢洞察端點。
限時動態可透過 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 監察
驗證日期