透過 API 的 Instagram 洞察:帳戶與貼文指標
Instagram API 會為專業帳戶,以及其每則貼文、Reels 與 Stories 回傳洞察。帳戶指標包括觸及、觀看次數、互動帳戶、追蹤與取消追蹤、讚好、留言、儲存及分享;貼文指標包括觸及、觀看次數、讚好、留言、儲存及分享。Meta 指出數據最多可延遲 48 小時。
easyCoexistence 使用 get_social_insights 讀取 Instagram 洞察,因此您可以請 Claude 或 ChatGPT 直接取得上週貼文的表現,包括觸及、觀看次數、讚好、留言、儲存及分享,可以是整個帳戶,亦可以是單則貼文。
Instagram 指標數據可延遲多久。
低於此門檻時,帳戶將不會回傳追蹤與取消追蹤數,以及追蹤者人口統計。
Meta 儲存媒體指標的期限。
Stories 指標透過 API 仍可查閱的時間。
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 小時。
- 在同時請求多項指標時加入細分。若其中一項不支援,整個呼叫便會失敗。
每個連接每月由 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 監察
驗證日期