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

API 中的 Instagram 說明文字限制:字元、主題標籤及 @ 標籤

Instagram API 可發佈相片、Reel 或輪播的說明文字,最多 2,200 字元及 20 個 @ 標籤。截至 2026 年 11 月,Instagram 說明中心允許每則貼文 5 個主題標籤,但 Meta 的 API 參考文件仍列出 30 個,因此請維持在 5 個以內。被 @ 提及的帳戶會於貼文發佈時收到通知;說明文字過長會以代碼 36004、子代碼 2207010 失敗。

easyCoexistence 透過 publish_instagram_post,從 Claude、ChatGPT 或您自己的程式發佈相片、輪播或 Reel 及其說明文字,在輪播上只需設定一次說明文字;list_social_posts 可讀回每則貼文的說明文字。

2,200

透過 Instagram API 可使用的說明文字字元上限。

5

Instagram 幫助中心現時允許單一貼文使用的主題標籤數上限,包括說明文字及留言中的。

30

Meta 的 API 參考文件中,每則說明文字的主題標籤數上限,該文件仍列出舊數字。

20

單一說明文字的 @ 標籤數上限;超出時返回代碼 100,子代碼 2207040。

2207010

錯誤代碼 36004 下的子代碼,表示說明文字長度超出 Instagram 允許的上限。

Partial

media_publish 可能以 config_issue CAPTION_NOT_ATTACHED 成功:貼文已發佈,但沒有說明文字。

說明文字有哪些限制?

共三項,全部套用於媒體容器的 caption 參數。說明文字可包含主題標籤(格式為 #標籤)及 Instagram 帳戶的用戶名稱(格式為 @用戶名稱),但須符合以下限制:

  • 字元數:最多 2,200 個。
  • 主題標籤:依 Instagram 說明中心,每則貼文最多 5 個,並計入留言中的主題標籤;Meta 的 API 參考文件仍列出 30 個。
  • @ 標籤:最多 20 個,每位被提及的帳戶會於貼文發佈時收到通知。

哪些貼文可以加說明文字?

相片、Reel 及輪播。輪播的說明文字須加在輪播容器上,因為其內的圖片及影片不支援說明文字;Meta 的參考文件並無列出限時動態的說明文字,因此限時動態的文字應放在圖片或影片本身。

說明文字違反限制時會怎樣?

請求會失敗,並返回指出問題的錯誤。說明文字過長時返回代碼 36004、子代碼 2207010,而 Meta 提供的修正方法會重申限制:最多 2,200 字元、30 個主題標籤及 20 個 @ 標籤。@ 標籤超過 20 個時,也可能返回代碼 100、子代碼 2207040。請縮短說明文字後重新發送請求。

被提及的帳戶何時收到通知?

於容器發佈時,而非建立時。說明文字中被 @ 提及的帳戶會在該時刻收到通知,因此提前準備的容器在發佈前不會通知任何人。Meta 每則說明文字 20 個 @ 標籤的上限適用於這些提及。

貼文可以在沒有說明文字的情況下發佈嗎?

可以。media_publish 可能成功,同時 config_issue 欄位設為 CAPTION_NOT_ATTACHED,表示媒體已發佈,但沒有說明文字。Meta 稱此為部分成功:媒體 ID 仍然有效,因此應核對該貼文,而非重新發佈。

發佈後可以更改說明文字嗎?

Meta 的媒體參考文件只記錄了已發佈媒體的一項更新:使用 POST /<IG_MEDIA_ID> 及 comment_enabled 開啟或關閉留言。該文件並未列出任何編輯說明文字的方法,因此應於建立容器前檢查文字、主題標籤及 @ 標籤。

常見錯誤

  • 只檢查字數。少於 2,200 字元的說明文字,若超過 Instagram 目前的規定(5 個主題標籤),或超過 20 個 @ 標籤,仍會違反限制。
  • 為輪播內的項目加上說明文字。只有輪播容器可以加說明文字。
  • 為限時動態撰寫說明文字。限時動態的容器不接受說明文字,應把文字放在圖片或影片中。
  • 收到 CAPTION_NOT_ATTACHED 後重新發佈。第一次發佈的貼文已經上線,再次發佈會建立重複的貼文。
使用 EasyCoexistence 完成這項設定

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

常見問題

Instagram 的錯誤 2207040 是什麼意思?

說明文字的 @ 標籤超過 20 個,以代碼 100 返回。請刪除標籤,直至剩下 20 個或以下,然後重新發送請求。

Instagram 的 5 個主題標籤上限包括留言中的主題標籤嗎?

包括。Instagram 幫助中心允許單一貼文最多 5 個主題標籤,當中計算說明文字及留言中的主題標籤。

可以透過 API 關閉已發佈貼文的留言功能嗎?

可以。使用 POST /<IG_MEDIA_ID> 並將 comment_enabled 設為 false 可關閉留言,設為 true 則重新開啟。這是 Meta 媒體參考文件中記錄的、已發佈媒體唯一一項更新。

錯誤 2207010 是什麼意思?

說明文字超過 Instagram 允許的長度。請縮短至 2,200 字元或以下,然後重新發送請求。

繼續閱讀

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

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

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

驗證日期