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

透過 API 的 Instagram 洞察:帳戶與貼文指標

Instagram API 會為專業帳戶,以及其每則貼文、Reels 與 Stories 回傳洞察。帳戶指標包括觸及、觀看次數、互動帳戶、追蹤與取消追蹤、讚好、留言、儲存及分享;貼文指標包括觸及、觀看次數、讚好、留言、儲存及分享。Meta 指出數據最多可延遲 48 小時。

easyCoexistence 使用 get_social_insights 讀取 Instagram 洞察,因此您可以請 Claude 或 ChatGPT 直接取得上週貼文的表現,包括觸及、觀看次數、讚好、留言、儲存及分享,可以是整個帳戶,亦可以是單則貼文。

48 hours

Instagram 指標數據可延遲多久。

100 followers

低於此門檻時,帳戶將不會回傳追蹤與取消追蹤數,以及追蹤者人口統計。

2 years

Meta 儲存媒體指標的期限。

24 hours

Stories 指標透過 API 仍可查閱的時間。

21 Apr 2025

impressions 於所有 API 版本停止運作的時間(2024 年 7 月 2 日前建立的媒體除外),改由 views 取代。

哪些帳戶指標可用?

使用 GET /<IG_ID>/insights 讀取,多數情況採用 period=day 及 metric_type=total_value:

  • reach:看過該內容的不重複帳戶數,包括廣告;為估算值。
  • views:內容被播放或顯示的次數。
  • accounts_engaged:與該內容互動的帳戶數,包括廣告;為估算值。
  • follows_and_unfollows:指定期間內的追蹤與取消追蹤數;需至少 100 名追蹤者。
  • likes、comments、saves、shares、replies 及 reposts,另加 total_interactions。
  • profile_links_taps:點擊商業地址、致電、電郵及短訊按鈕的次數。
  • follower_demographics 與 engaged_audience_demographics:年齡、城市、國家及性別。

哪些貼文指標可用?

使用 GET /<IG_MEDIA_ID>/insights 讀取;可用指標視乎格式而定。對於貼文或 Reels,likes、comments、views 及總互動次數只計算自然互動,不包括由其製作的廣告所產生的互動。

  • 貼文及 Reels:reach、views、likes、comments、saved、shares、total_interactions 及 reposts。
  • 僅限 Reels:ig_reels_avg_watch_time、ig_reels_video_view_total_time 及 reels_skip_rate。
  • 貼文及 Stories:follows、profile_visits 及 profile_activity。
  • Stories:reach、views、shares、replies、navigation、reposts 及 total_interactions。

period、metric_type 與細分如何運作?

帳戶指標採用 period=day。metric_type=total_value 會為整個期間回傳一個數值,細分功能須使用此設定;time_series 則按日回傳數值,只適用於 reach。細分會按 media_product_type(貼文、輪播、Reels、Stories 及廣告)、follow_type(追蹤者或非追蹤者)或 contact_button_type 拆分總數。

人口統計指標採用 this_week 或 this_month 等 timeframe,而非 since 及 until;若不提供 since 及 until,其他指標則回溯 24 小時。若所要求的細分有某項指標不支援,整個請求會以 unknown error 失敗。

適用哪些門檻及延遲?

Meta 規定數字何時出現,以及可查閱的期限:

  • 數據最多可延遲 48 小時。
  • 追蹤者少於 100 人的帳戶不會獲得 follows_and_unfollows 或 follower_demographics;engaged_audience_demographics 則需要該期間內有 100 次互動。
  • 缺失或無法提供的數據會回傳空集,而非 0。
  • 人口統計指標只回傳前 45 個數值。
  • 帳戶指標最多儲存 90 天,媒體指標最多儲存 2 年。

Stories 與輪播有何不同?

Stories 指標只可查閱 24 小時;數值低於 5 時,會回傳錯誤代碼 10(not enough viewers),而非數字。來自歐洲及日本人士的回覆不予計算,而由該地區帳戶建立的 Story 則會顯示回覆數為 0。使用 Instagram Login 時沒有 story_insights webhook,因此必須在 Story 仍然可見時讀取其數據。

輪播會以一則貼文呈報:Meta 不會回傳其中相片及影片的洞察數據。

為何指標名稱會改變?

因為 Meta 會在 API 版本之間淘汰及更改指標名稱。impressions 於 v22.0 已被棄用,並於 2025 年 4 月 21 日在所有版本停止運作,2024 年 7 月 2 日前建立的媒體除外;其位置改由 views 取代。plays、clips_replays_count 及 ig_reels_aggregated_all_plays_count 同時被淘汰。video_views 及數項個人檔案時間序列(包括 profile_views)更早前已被移除。使用已淘汰名稱的請求會失敗,因此為較早 API 版本編寫的指標清單可能需要更新。

常見錯誤

  • 請求 impressions。此指標在任何 API 版本中均已無法使用;請改為要求 views。
  • 把空結果當作零。當指標無法提供時,Meta 會回傳空數據集,這與沒有活動並不相同。
  • 在 Story 結束後才讀取其指標。Stories 指標只可查閱 24 小時。
  • 在同時請求多項指標時加入細分。若其中一項不支援,整個呼叫便會失敗。
使用 EasyCoexistence 完成這項設定

每個連接每月由 US$ 9 降至 US$ 0.75,連接越多越便宜,首 3 天免費試用。

常見問題

Instagram API 中,什麼取代了 impressions?

views,即內容被播放或顯示的次數。Meta 已於 2025 年 4 月 21 日在所有 API 版本淘汰 impressions,2024 年 7 月 2 日前建立的媒體除外。

為何我的帳戶沒有追蹤者數據?

Meta 不會為追蹤者少於 100 人的帳戶回傳 follows_and_unfollows 或追蹤者人口統計。

最多可回溯多久讀取 Instagram 洞察?

帳戶指標最多 90 天,媒體指標最多 2 年;online_followers 只涵蓋過去 30 天。

數字是否包括廣告?

部分包括。帳戶的 reach 及 accounts engaged 包括廣告,而貼文的 likes、comments 及 views 只計算自然互動。

繼續閱讀

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

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

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

驗證日期