使用 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 帖子的永久链接,可直接传给 oEmbed。
自该日期起,Meta 的 Instagram oEmbed API 在所有版本中均可无需访问令牌调用。
Meta 的 oEmbed 指南允许的每小时请求数。
maxwidth 接受的取值范围;不支持 maxheight。
author_name、author_url 和缩略图字段从所有 API 版本的 Instagram oEmbed 响应中移除的日期。
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?
共三种格式,指南在 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 边(edge)仍会返回 username、permalink 和 thumbnail_url。
哪些内容无法嵌入?
Meta 的指南列出了端点不涵盖的内容,并规定了一条使用规则:
- 私人账户、未激活账户和有年龄限制账户的帖子。
- 已关闭嵌入功能的账户。
- 快拍(Stories),以及在 Shadow DOM 内渲染嵌入内容的页面。
- 超出前端展示的任何用途:Meta 严禁将该端点的元数据或内容用于其他目的。
如何嵌入您自己账户的帖子?
获取每条帖子的永久链接(permalink),并将其作为 url 传入。通过 easyCoexistence,list_social_posts 会返回已连接账户的近期帖子及其永久链接,无论是从 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()。
借助 Meta 官方 API,Claude、ChatGPT 或您自己的代码还可以在该账户上发布、定时发布并回复评论和私信。每个连接每月 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 监控
验证时间