Log inStart Free Trial
easyCoexistence Official APIs

Embedding Instagram posts on a website with oEmbed

Meta's Instagram oEmbed endpoint, GET /instagram_oembed?url=<POST_URL>, returns the HTML that embeds a public Instagram post or Reel on a web page, along with version, provider_name, provider_url, type and width. Since 15 May 2026 it can be called without an access token, and the HTML loads Instagram's embed.js to draw the post.

easyCoexistence returns each connected Instagram post's permalink through list_social_posts, ready to pass to oEmbed, and lets Claude, ChatGPT or your own code publish, schedule and reply to comments and DMs on the account through Meta's official API.

15 May 2026

Since this date, Meta's Instagram oEmbed API can be called without an access token, in all versions.

1,000/hour

Requests per hour that Meta's oEmbed guide allows.

320 to 658

The range maxwidth accepts; maxheight is not supported.

3 Nov 2025

When author_name, author_url and the thumbnail fields left Instagram oEmbed responses in all API versions.

Stories

Not supported by the oEmbed endpoint, nor are posts from private, inactive or age-restricted accounts.

How does Instagram's oEmbed endpoint work?

You send the URL of a public post and get back the HTML that displays it. The endpoint runs on Meta's main Graph API host, the one Facebook Login calls use, rather than graph.instagram.com, and the response is a small JSON object whose html field goes into the page as it is.

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>"
}

Which URLs does it accept?

Three formats, as Meta's guide lists them for the url parameter, which can be sent plain or URL-encoded; the guide's two sample requests show one of each:

  • Single image and carousel posts: https://www.instagram.com/p/{media-shortcode}/
  • Videos and Reels: https://www.instagram.com/reel/{media-shortcode}/
  • Profiles: https://www.instagram.com/{username}

Does it need an access token?

Not since 15 May 2026, when Meta's changelog says the Instagram oEmbed API became callable without one. Before that, apps needed the Meta oEmbed Read feature through App Review and a token on each call, and token-based access still works. Meta's oEmbed guide allows up to 1,000 requests an hour, and Meta's announcement of tokenless access said token-based apps may get higher rate limits.

Which parameters does it take?

Four besides url, from Meta's guide and its reference:

  • maxwidth: from 320 to 658; the embed is otherwise responsive, and maxheight is not supported.
  • hidecaption: true hides the post's caption; it is false by default.
  • omitscript: true leaves the script out of the HTML, for pages that load embed.js once themselves and call instgrm.Embeds.process().
  • fields: limits the response to the fields named.

What does the response contain?

Six default fields: html, the markup to display; version, always 1.0; provider_name and provider_url, which name Instagram; type, the oEmbed resource type; and width, in pixels. Meta removed author_name, author_url, thumbnail_url, thumbnail_width and thumbnail_height from Instagram post responses in all API versions on 3 November 2025. For posts on your own account, the media edge still returns username, permalink and thumbnail_url.

What can't be embedded?

Meta's guide lists what the endpoint leaves out, and one rule on its use:

  • Posts on private, inactive and age-restricted accounts.
  • Accounts that have turned off embeds.
  • Stories, and pages that render the embed inside a Shadow DOM.
  • Any use beyond a front-end view: Meta strictly prohibits using the endpoint's metadata or content for other purposes.

How do you embed your own account's posts?

Take each post's permalink and pass it as url. Through easyCoexistence, list_social_posts returns the connected account's recent posts with their permalinks, from Claude, ChatGPT or your own code, and since the oEmbed call needs no token, your site can make it directly.

Common mistakes

  • Sending a Story link. Meta's oEmbed endpoint does not support Stories, so embed a post or Reel.
  • Reading thumbnail_url from the response. Meta removed it, with author_name and the other thumbnail fields, on 3 November 2025.
  • Setting maxwidth below 320 or above 658. Meta accepts values in that range only, and no maxheight at all.
  • Loading embed.js with each embed. With omitscript set to true, load the script once and call instgrm.Embeds.process().
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Can I embed an Instagram Reel?

Yes. Pass its https://www.instagram.com/reel/{media-shortcode}/ URL, and the endpoint returns the embed HTML.

Is the Instagram embed responsive?

Yes. Meta's guide says the embed is responsive, and maxwidth sets the widest it will be.

Can I embed an Instagram profile?

Yes. Meta's guide lists profile URLs, https://www.instagram.com/{username}, among the formats the url parameter accepts.

Can I use oEmbed data for analytics?

No. Meta allows the endpoint only for showing the post on a page or in an app, and prohibits other uses of its metadata and content.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on