透過 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 或你自己的程式,能直接從 Meta 取得已連接帳戶的 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 則回傳該帳戶近期貼文與 Reel 的媒體 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 會回傳空的數據集。
每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,首 3 天免費。
常見問題
為什麼 Reels 數據分析請求會回傳空結果?
當數據不存在或暫時無法提供時,Meta 會回傳空的數據集,而非 0;指標背後的數據最多可延遲 48 小時。
如何從 API 取得 Reels 觀看時長?
請求 GET /<IG_MEDIA_ID>/insights 時,ig_reels_avg_watch_time 取平均值,ig_reels_video_view_total_time 取總時長(包括重播)。
什麼是 reels_skip_rate?
在首次觀看中,於前 3 秒內跳過 Reel 的觀看次數百分比。Meta 於 2025 年 12 月 3 日加入此指標,並將其標示為估算值及開發中。
Reels 數據分析是否包括廣告觀看?
不包括。likes、comments、views 與 total_interactions 只計算自然互動;包括推廣媒體的 total_views 則僅限使用 Facebook Login 時提供。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期