以 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 在帳戶上發佈、排程,以及回覆留言與私訊。
自此日期起,Meta 的 Instagram oEmbed API 在所有版本中均可無需存取權杖呼叫。
Meta 的 oEmbed 指南所允許的每小時請求數。
maxwidth 接受的範圍;不支援 maxheight。
author_name、author_url 及縮圖欄位從 Instagram oEmbed 回應中移除,適用於所有 API 版本。
oEmbed 端點不支援限時動態,亦不支援私人、停用或受年齡限制帳戶的貼文。
Instagram 的 oEmbed 端點如何運作?
您發送公開貼文的 URL,即會取回顯示該貼文的 HTML。此端點運行於 Meta 的主要 Graph API 主機,即 Facebook Login 所用的同一主機,而非 graph.instagram.com。回應是一個小型 JSON 物件,其 html 欄位可原樣放入頁面。
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()。
每個連接每月 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 監察
驗證日期