2026 年 Instagram API 指南:由應用程式到首篇帖文
2026 年,Instagram API 由應用程式到首篇帖文分為六個步驟:專業帳戶、登入設定、Meta 應用程式、符合存取級別的權限、存取權杖,然後以 POST /<IG_ID>/media 建立媒體容器,再以 media_publish 發佈。留言、私訊、Webhook、洞察分析及 Meta 的限制則在其後。新應用程式方面,Meta 建議使用 Unified Login。
easyCoexistence 將步驟二至五簡化為一次 Instagram 登入:其 Meta 應用程式負責登入、在存取權杖到期前更新,並每 6 小時檢查一次帳戶;Claude、ChatGPT 或您自己的平台則透過 Meta 官方 API 發佈、排程、回覆留言與私訊,並讀取洞察分析。
Unified Login 為新整合建議使用,另有 Instagram Login 與 Facebook Login,供現有整合繼續使用。
Meta 的遷移指南指出,新建立的 Meta 應用程式無法以 Instagram Login 設定 Instagram API。
長效 Instagram 使用者存取權杖的有效期;權杖滿 24 小時後即可更新。
一個帳戶在 24 小時滾動週期內可透過 API 發佈的帖文數量,輪播計為一則。
據 Meta 所述,應用程式審查通常在一週內完成一次提交的處理。
從新應用程式到首篇帖文需要哪些步驟?
首篇帖文需要六個步驟,之後另有四個步驟決定應用程式的後續功能。帳戶必須為專業帳戶,應用程式需選定 Meta 三種登入設定之一,帳戶擁有者授予權限,應用程式的伺服器則保存存取權杖。發佈帖文只需兩次呼叫。留言、私訊、Webhook、洞察分析及限制依次排列,最後幾節會列出涵蓋各步驟的頁面。
步驟一:哪些 Instagram 帳戶可以使用 API?
專業帳戶,即商業帳戶或創作者帳戶。Meta 的 Instagram Platform 只服務專業帳戶,兩種類型在發佈、留言、私訊及洞察分析上的運作方式相同。個人帳戶可在 Instagram 應用程式的「帳戶類型和工具」中切換,私人帳戶切換後會變為公開。Instagram Login 與 Unified Login 不需要連結粉絲專頁,Facebook Login 則須連結一個您可管理的粉絲專頁。
步驟二:應用程式應使用哪種登入設定?
Meta 記錄了三種設定,選擇會決定主機、存取權杖及權限名稱。其概覽建議新整合使用 Unified Login,其 Unified Login 頁面指出新的 Instagram API 功能只在該設定中推出,而遷移指南則指新建立的應用程式無法設定 Instagram Login。現有的 Instagram Login 整合會繼續運作,目前未公布結束日期。
- Unified Login:客戶可以透過 Instagram 或 Facebook Login 登入,選擇 Business Portfolio,應用程式會收到 Business Integration System User 存取權杖。
- Instagram Login:擁有者透過 Instagram 登入,呼叫會發送至 graph.instagram.com,並使用 Instagram 使用者存取權杖及 instagram_business_* 權限。
- Facebook Login:帳戶必須連結到該人可管理的粉絲專頁,並使用 instagram_* 權限及粉絲專頁權限。
步驟三:如何建立 Meta 應用程式?
在應用程式控制台中建立,路徑視所選設定而定。Meta 的 Unified Login 指南由一個屬於 Business Portfolio 的應用程式開始,並使用「在 Instagram 上管理訊息與內容」用途。在 Unified Login 的 API 設定中,應用程式會建立一個設定,其 config_id 指明要求的權限與資源,儲存 HTTPS 重新導向 URL,並複製登入網址。既有的 Instagram Login 應用程式會保留以 Instagram Login 進行的 API 設定,其 Instagram 應用程式 ID 與密鑰儲存於此。
步驟四:應用程式需要哪些權限及存取級別?
每項功能對應一項權限,由帳戶擁有者在登入時授予。Unified Login 使用 instagram_* 系列,例如 instagram_content_publish 與 instagram_manage_comments;Instagram Login 則使用 instagram_business_* 名稱。預設的標準存取權限涵蓋您擁有或管理的帳戶,以及在應用程式中擔任角色的人士。若要為其他商家的帳戶提供服務,則須取得進階存取權限,逐項權限透過應用程式審查及商家驗證申請。
步驟五:應用程式如何取得存取權杖?
由擁有者登入後取得,並在伺服器端交換,絕不在瀏覽器或行動應用程式中進行。使用 Instagram Login 時,重新導向會附帶一個代碼,有效一小時並只能使用一次;代碼會換取短效存取權杖,再換取有效 60 天的長效存取權杖,並可於滿一天後更新。使用 Unified Login 時,代碼會換取 Business Integration System User 存取權杖,其到期時間視設定而定。
步驟六:如何發佈首篇帖文?
以兩次呼叫完成。POST /<IG_ID>/media 附上 Meta 會自行抓取的公開 image_url,建立一個容器;POST /<IG_ID>/media_publish 以該容器的 ID 作為 creation_id 發佈,並回傳媒體 ID。圖片必須為 JPEG。若為 Reel 或其他影片,請檢查容器的 status_code,直至顯示 FINISHED,否則過早發佈會失敗。
POST https://graph.instagram.com/v26.0/<IG_ID>/media
?image_url=https://www.example.com/images/first-post.jpg
&caption=Hello%20from%20the%20API
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_CONTAINER_ID>" }
POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
?creation_id=<IG_CONTAINER_ID>
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_MEDIA_ID>" }步驟七:留言與私訊如何運作?
兩者都由他人發起。GET /<IG_MEDIA_ID>/comments 每次請求最多返回 50 則頂層留言,POST /<IG_COMMENT_ID>/replies 可公開回覆一則留言,私人回覆則會於留言後 7 天內向留言者發送一則私訊。私訊只能發給先行發訊的人,大多數動作的標準時限為 24 小時,前提是擁有者已在 Instagram 應用程式中開啟「允許存取訊息」。
步驟八:Webhook 如何告知應用程式發生了什麼事?
Meta 會以 POST 方式向 HTTPS 端點發送 JSON。端點須先透過回傳 hub.challenge 一次性證明自身,之後每則事件都會在 X-Hub-Signature-256 中附上以應用程式密鑰為金鑰、對負載計算的 HMAC-SHA256 簽名。應用程式可在應用程式控制台中選取 comments 及 messages 等欄位,再透過 subscribed_apps 邊緣為每個帳戶訂閱。通知只發送至正式版應用程式,而留言通知需要進階存取權限。
步驟九:應用程式如何讀取洞察分析?
透過兩個邊緣:GET /<IG_ID>/insights 用於帳戶,GET /<IG_MEDIA_ID>/insights 用於帖文、Reel 或限時動態。觸及人數、views 與 accounts_engaged 等帳戶指標,應以 period=day 及 metric_type=total_value 查詢。views 於 2025 年取代了 impressions,部分指標需要至少 100 名追蹤者,而 Meta 指出數據可能延遲最多 48 小時。
步驟十:哪些限制會影響應用程式?
Meta 的主要限制以帳戶計算,因此每個新帳戶都有自己的配額,而非共用一個:
- 呼叫:每個應用程式及帳戶在滾動 24 小時內最多為該帳戶曝光次數的 4,800 倍,不含訊息功能。
- 發佈:每個帳戶 24 小時內最多 100 篇經 API 發佈的帖文及 400 個媒體容器。
- 訊息:文字的 Send API 每秒 100 次呼叫,帖文及 Reel 的私人回覆每小時 750 次。
- 容器:未發佈的容器若 24 小時仍未使用即會過期,需重新建立。
各步驟的詳細說明在哪個頁面?
本文件中,每個步驟各有一個參考頁面,收錄本指南未涵蓋的欄位、錯誤及特殊情況。以下路徑位於網站位址之下,而程式碼頁面則並列顯示 Python 與 Node.js 的發佈、留言、洞察分析及 Webhook 呼叫:
透過 easyCoexistence 的途徑是怎樣的?
以單一登入取代步驟二至五及 Webhook 設定。在控制台中選擇「新增連接」,再選 Instagram,以商業或創作者帳戶登入,並核准其五項 instagram_business_* 權限。easyCoexistence 的 Meta 應用程式負責登入、更新存取權杖,並每 6 小時檢查一次帳戶。Claude、ChatGPT 或您自己的代理隨後可透過 https://easycoexistence.com/api/mcp 運作;您自己的程式碼可從 get_social_credentials 取得帳戶的 ID 及 API 基底網址,而帖文可最多提前 90 天從 easyCoexistence 的排程隊列排程。
常見錯誤
- 以 Instagram Login 開始一個新應用程式。Meta 的遷移指南指出,新建立的應用程式無法設定此登入,而其概覽建議新整合使用 Unified Login。
- 以 Instagram 使用者存取權杖呼叫 Unified Login 整合。Meta 的 Webhook 指南指出,這些權杖及 graph.instagram.com 不適用於 Unified Login。
- 未等待便立即發佈影片容器。media_publish 會因子代碼 2207027 失敗,直至容器的 status_code 顯示 FINISHED。
- 以輪詢方式讀取留言與私訊。Meta 建議使用 Webhook,這可減少應用程式的呼叫次數,並降低受速率限制的風險。
每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,首 3 天免費。
常見問題
取得 Instagram API 存取權限需要多久?
對於您擁有或管理的帳戶,無需等候,標準存取權限自始即可使用。若要為其他商家提供服務,則需要應用程式審查及商家驗證;據 Meta 所述,審查通常不足一週即可完成。
新的 Meta 應用程式仍可使用 Instagram Login 嗎?
根據 Meta 的遷移指南,不可以,該指南指出新建立的應用程式無法設定此登入。現有的 Instagram Login 整合會繼續運作,Meta 亦未公布任何結束日期。
API 可以從我的電腦上傳檔案發佈嗎?
不可以,使用 Instagram Login 時,Meta 會從公開網址抓取每個圖片或影片。Meta 記錄了可續傳上傳的功能,可接受本地影片檔案,適用於以 Facebook Login for Business 建立的設定,包括 Unified Login。
easyCoexistence 每個 Instagram 帳戶的費用是多少?
每個 Instagram 帳戶即為一個連接:每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,首 3 天免費。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期