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

Instagram API 速率限制:24 小時內的呼叫次數與私訊處理量

Instagram 的 API 為每個應用程式所服務的各個帳戶提供呼叫配額:以過去 24 小時的滾動期間計,配額為該帳戶曝光次數的 4,800 倍。私訊另有各帳戶的獨立速率限制:透過 Send API 的文字訊息每秒 100 則,音訊或影片每秒 10 則,私人回覆每小時 750 則。超出配額後,呼叫會因錯誤 80002 而失敗,X-Business-Use-Case-Usage 標頭則顯示已用量。

easyCoexistence 可在每個 Instagram 帳戶的留言、提及及私訊抵達時,即時轉發至您的端點,因此代理會回應事件,而非輪詢。

4,800

應用程式在過去 24 小時滾動期間內,就單一帳戶每次曝光可進行的呼叫次數,不包括訊息。

750/hour

每個帳戶對貼文及 Reels 留言的私人回覆數;直播留言則每秒允許 100 則。

100/sec

每個帳戶透過 Send API 發送文字、連結、反應及貼圖的呼叫次數;音訊或影片則允許 10 次。

100 posts

每個帳戶在 24 小時滾動期間內透過 API 發布的帖文數量,於發布容器時強制執行。

80002

應用程式達到 Instagram Business Use Case 速率限制時會收到的錯誤代碼。

Instagram 如何計算 API 呼叫次數?

以應用程式與帳戶的配對計算,為過去 24 小時的滾動期間。Instagram 的端點適用 Meta 的 Business Use Case 速率限制,而應用程式對單一專業帳戶的呼叫次數,上限為該帳戶曝光次數的 4,800 倍。曝光次數指過去 24 小時內,其任何內容出現在他人畫面上的次數。訊息另行計算;Business Discovery 及 Hashtag Search 則改為遵循 Meta 的平台速率限制。

一個帳戶的用量會影響另一個帳戶嗎?

按此公式,不會。Meta 為每個應用程式及應用程式使用者的配對保留計數,因此服務多個專業帳戶的應用程式,每個帳戶各有獨立配額,並依該帳戶本身的曝光次數而定。內容被看見次數較多的帳戶可獲得較多呼叫,而新帳戶或曝光較少的帳戶則獲得較少。

訊息功能有哪些限制?

與 24 小時計數分開,並按每個 Instagram 專業帳戶及每個 API 設定:

  • Send API:文字、連結、反應及貼圖每秒 100 次呼叫,音訊或影片每秒 10 次。
  • 私人回覆:貼文及 Reels 留言每小時 750 次呼叫,直播留言每秒 100 次。
  • Conversations API:每秒 2 次呼叫。

發布上限屬於哪個部分?

與呼叫配額並存,屬獨立的帖文計數。Meta 的發布指南允許每個帳戶在 24 小時滾動期間內透過 API 發布 100 則帖文,於呼叫 POST /<IG_ID>/media_publish 時檢查。超出上限的呼叫會以代碼 9、子代碼 2207042 失敗。一則帖文可容納的內容、容器數目及 content_publishing_limit 則屬發布限制的範疇。

Meta 如何回報用量?

於回應標頭中回報。依 Business Use Case 限制而發出的呼叫會回傳 X-Business-Use-Case-Usage,即以 ID 為鍵的 JSON 字串。就 Instagram 而言,其 type 欄位為 instagram;call_count、total_cputime 及 total_time 為已用配額的百分比。當 CPU 時間或總時間達到 100 時,呼叫可能會被限流。estimated_time_to_regain_access 以分鐘計,顯示受限應用程式可再次呼叫前所需的時間。

The usage header on an Instagram call
x-business-use-case-usage: {
  "<ID>": [
    {
      "type": "instagram",
      "call_count": 28,
      "total_cputime": 12,
      "total_time": 15,
      "estimated_time_to_regain_access": 0
    }
  ]
}

達到上限時會發生什麼事?

呼叫會失敗,直至計數回落至上限以下。就 Instagram 的 Business Use Case 限制而言,錯誤代碼為 80002。Meta 警告,受限期間發出的呼叫仍會計入計數,而這會延後呼叫重新成功的時間點。訊息與此配額分開計算,採用其獨立的每秒及每小時速率限制。

如何保持在限制之內?

Meta 本身的建議,應用於 Instagram:

  • 以 Webhook 接收留言、提及及訊息,而非輪詢;Meta 建議採用此方法以減少應用程式所需的呼叫。
  • 平均分配呼叫,避免集中爆發式發送。
  • 只索取所需的欄位,並避免索取相互重疊的資料。
  • 批次中的呼叫須逐一計算:Meta 會將批次內的每個請求計為一次獨立呼叫。
  • 受限時停止,並於 estimated_time_to_regain_access 所示時間後恢復。

常見錯誤

  • 在迴圈中重試受限的呼叫。Meta 會計算受限期間發出的呼叫,這會延後呼叫重新成功的時間點。
  • 輪詢新留言或私訊。Webhook 會在事件發生時即時傳送,並減少呼叫計數。
  • 把 estimated_time_to_regain_access 當成秒數。Meta 以分鐘為單位,因此若客戶端等待該數值的秒數,便會在仍受限時再次呼叫。
  • 只監察 call_count。total_cputime 及 total_time 同樣計入限流,因此應追蹤標頭中的全部三個百分比。
使用 EasyCoexistence 完成這項設定

當 Meta 限流某個呼叫時,Claude、ChatGPT 或您自己的程式碼會取得 Meta 的錯誤代碼及訊息。系統亦每 6 小時檢查一次每個已連接的帳戶。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並提供首 3 天免費試用。

常見問題

Instagram 帳戶每天可以進行多少次 API 呼叫?

為其內容在過去 24 小時內每次曝光可獲得的 4,800 次,按應用程式及帳戶計算,因此曝光次數較多的帳戶可獲得較多呼叫。

Instagram API 錯誤 80002 是什麼?

Instagram 的 Business Use Case 速率限制:應用程式已用盡該帳戶的呼叫配額。請停止呼叫,並等待用量標頭所示的時間。

私訊會計入 4,800 的計算公式嗎?

不會。訊息不在該公式之內,並有各自的每個帳戶速率限制,例如透過 Send API 每秒 100 則文字訊息。

私人回覆與私訊共用速率限制嗎?

不共用。Meta 為私人回覆另訂速率限制:每個帳戶對貼文及 Reels 留言的私人回覆每小時 750 次,直播留言每秒 100 次,與私訊的 Send API 速率限制各自分開。

繼續閱讀

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

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

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

驗證日期