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

透過 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 的原始錯誤。

3 seconds

reels_skip_rate 的量度範圍:在 Reel 前 3 秒內被跳過的觀看次數佔比。

21 Apr 2025

plays、clips_replays_count 與 ig_reels_aggregated_all_plays_count 在所有 API 版本中被棄用的日期。

3 Dec 2025

reels_skip_rate、reposts、crossposted_views 與 facebook_views 加入媒體數據分析的日期。

48 hours

媒體指標數據可延遲的時長。

2 years

Meta 儲存媒體指標的時長。

Reel 會回傳哪些指標?

以下是 Meta 媒體數據分析參考列出、適用於 media_product_type REELS 的指標,透過 GET /<IG_MEDIA_ID>/insights 並以逗號分隔的 metric 參數讀取。Meta 會在部分指標旁註明其為估算值或開發中,並且只把讚好與留言計為自然互動:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

Reels 數據分析請求會回傳什麼?

data 內每個指標一個物件,各包含 name、period、values、title、description 與 id。period 固定為 lifetime:這是 Meta 為媒體指標設定的值,無法更改,所以請求中無需指定。Meta 的參考資料把兩個觀看時長指標描述為時間量,但沒有註明單位,因此在繪製圖表前,請先用一個你已知的 Reel 核對。

A Reels insights request and the shape of its answer
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 年之前撰寫的指標清單需要更新:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

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。

get_social_insights arguments for one Reel
{
  "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 會回傳空的數據集。
使用 EasyCoexistence 完成這項設定

每個連接每月 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 監察

驗證日期