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

以 oEmbed 在網站嵌入 Instagram 貼文

Meta 的 Instagram oEmbed 端點為 GET /instagram_oembed?url=<POST_URL>,會回傳可在網頁嵌入公開 Instagram 貼文或 Reel 的 HTML,並附上 version、provider_name、provider_url、type 與 width。自 2026 年 5 月 15 日起,無需存取權杖即可呼叫,而 HTML 會載入 Instagram 的 embed.js 來繪製貼文。

easyCoexistence 透過 list_social_posts 回傳每個已連接 Instagram 貼文的 permalink,可直接傳給 oEmbed;並讓 Claude、ChatGPT 或您自己的程式碼,透過 Meta 官方 API 在帳戶上發佈、排程,以及回覆留言與私訊。

15 May 2026

自此日期起,Meta 的 Instagram oEmbed API 在所有版本中均可無需存取權杖呼叫。

1,000/hour

Meta 的 oEmbed 指南所允許的每小時請求數。

320 to 658

maxwidth 接受的範圍;不支援 maxheight。

3 Nov 2025

author_name、author_url 及縮圖欄位從 Instagram oEmbed 回應中移除,適用於所有 API 版本。

Stories

oEmbed 端點不支援限時動態,亦不支援私人、停用或受年齡限制帳戶的貼文。

Instagram 的 oEmbed 端點如何運作?

您發送公開貼文的 URL,即會取回顯示該貼文的 HTML。此端點運行於 Meta 的主要 Graph API 主機,即 Facebook Login 所用的同一主機,而非 graph.instagram.com。回應是一個小型 JSON 物件,其 html 欄位可原樣放入頁面。

A request and its response
GET /instagram_oembed?url=https://www.instagram.com/p/<SHORTCODE>/

{
  "version": "1.0",
  "provider_name": "Instagram",
  "provider_url": "https://www.instagram.com/",
  "type": "rich",
  "width": 658,
  "html": "<EMBED_HTML>"
}

它接受哪些 URL?

共三種格式,按 Meta 指南所列 url 參數的格式,可以純文字或 URL 編碼傳送;指南的兩個範例請求各示範其中一種:

  • 單張圖片與輪播貼文:https://www.instagram.com/p/{media-shortcode}/
  • 影片與 Reel:https://www.instagram.com/reel/{media-shortcode}/
  • 個人檔案:https://www.instagram.com/{username}

是否需要存取權杖?

自 2026 年 5 月 15 日起不再需要。Meta 的變更日誌表示,Instagram oEmbed API 自此日起可無需權杖呼叫。在此之前,應用程式須透過 App Review 取得 Meta oEmbed Read 功能,並在每次呼叫時附上權杖,而基於權杖的存取仍然有效。Meta 的 oEmbed 指南允許每小時最多 1,000 次請求,Meta 宣布無需權杖存取時亦表示,基於權杖的應用程式可能獲得較高的速率限制。

它接受哪些參數?

除 url 外,另有四個參數,取自 Meta 指南及其參考文件:

  • maxwidth:範圍為 320 至 658;嵌入內容在其他情況下為響應式,且不支援 maxheight。
  • hidecaption:設為 true 時隱藏貼文說明文字;預設為 false。
  • omitscript:設為 true 時,HTML 不包含腳本,適用於頁面自行載入一次 embed.js 並呼叫 instgrm.Embeds.process() 的情況。
  • fields:將回應限制為指定的欄位。

回應包含哪些內容?

預設有六個欄位:html,即要顯示的標記;version,固定為 1.0;provider_name 與 provider_url,標示提供者為 Instagram;type,即 oEmbed 資源類型;以及 width,單位為像素。Meta 已於 2025 年 11 月 3 日在所有 API 版本中,從 Instagram 貼文回應移除 author_name、author_url、thumbnail_url、thumbnail_width 與 thumbnail_height。對於您自己帳戶的貼文,media 邊緣仍會回傳 username、permalink 與 thumbnail_url。

哪些內容無法嵌入?

Meta 指南列出端點不涵蓋的內容,以及一項使用規定:

  • 私人、停用及受年齡限制帳戶的貼文。
  • 已關閉嵌入功能的帳戶。
  • 限時動態,以及在 Shadow DOM 內呈現嵌入內容的頁面。
  • 除前端顯示外的任何用途:Meta 嚴格禁止將端點的中繼資料或內容用於其他目的。

如何嵌入自己帳戶的貼文?

取得每篇貼文的 permalink,並將其作為 url 傳入。透過 easyCoexistence,list_social_posts 會回傳已連接帳戶的近期貼文及其 permalink,無論是從 Claude、ChatGPT 還是您自己的程式碼呼叫。由於 oEmbed 呼叫無需權杖,您的網站可直接發出請求。

常見錯誤

  • 傳送限時動態連結。Meta 的 oEmbed 端點不支援限時動態,因此請嵌入貼文或 Reel。
  • 從回應讀取 thumbnail_url。Meta 已於 2025 年 11 月 3 日連同 author_name 及其他縮圖欄位一併移除。
  • 將 maxwidth 設為低於 320 或高於 658。Meta 只接受該範圍內的值,且完全不接受 maxheight。
  • 每次嵌入都載入 embed.js。當 omitscript 設為 true 時,應只載入一次腳本,並呼叫 instgrm.Embeds.process()。
使用 EasyCoexistence 完成這項設定

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

常見問題

我可以嵌入 Instagram Reel 嗎?

可以。傳入其 https://www.instagram.com/reel/{media-shortcode}/ URL,端點便會回傳嵌入 HTML。

Instagram 嵌入內容是否響應式?

是。Meta 指南表示嵌入內容為響應式,而 maxwidth 設定其最大寬度。

我可以嵌入 Instagram 個人檔案嗎?

是。Meta 指南將個人檔案網址 https://www.instagram.com/{username} 列為 url 參數接受的格式之一。

我可以將 oEmbed 數據用於分析嗎?

不可以。Meta 只允許端點用於在頁面或應用程式中顯示貼文,並禁止將其中繼資料及內容用於其他用途。

繼續閱讀

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

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

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

驗證日期