登录开始免费试用
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 帖子的永久链接,可直接传给 oEmbed。

15 May 2026

自该日期起,Meta 的 Instagram oEmbed API 在所有版本中均可无需访问令牌调用。

1,000/hour

Meta 的 oEmbed 指南允许的每小时请求数。

320 to 658

maxwidth 接受的取值范围;不支持 maxheight。

3 Nov 2025

author_name、author_url 和缩略图字段从所有 API 版本的 Instagram oEmbed 响应中移除的日期。

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?

共三种格式,指南在 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()。
使用 EasyCoexistence 完成这些操作

借助 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 监控

验证时间