Instagram API 速率限制:24 小時內的呼叫次數與私訊處理量
Instagram 的 API 為每個應用程式所服務的各個帳戶提供呼叫配額:以過去 24 小時的滾動期間計,配額為該帳戶曝光次數的 4,800 倍。私訊另有各帳戶的獨立速率限制:透過 Send API 的文字訊息每秒 100 則,音訊或影片每秒 10 則,私人回覆每小時 750 則。超出配額後,呼叫會因錯誤 80002 而失敗,X-Business-Use-Case-Usage 標頭則顯示已用量。
easyCoexistence 可在每個 Instagram 帳戶的留言、提及及私訊抵達時,即時轉發至您的端點,因此代理會回應事件,而非輪詢。
應用程式在過去 24 小時滾動期間內,就單一帳戶每次曝光可進行的呼叫次數,不包括訊息。
每個帳戶對貼文及 Reels 留言的私人回覆數;直播留言則每秒允許 100 則。
每個帳戶透過 Send API 發送文字、連結、反應及貼圖的呼叫次數;音訊或影片則允許 10 次。
每個帳戶在 24 小時滾動期間內透過 API 發布的帖文數量,於發布容器時強制執行。
應用程式達到 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 以分鐘計,顯示受限應用程式可再次呼叫前所需的時間。
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 同樣計入限流,因此應追蹤標頭中的全部三個百分比。
當 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 監察
驗證日期