oEmbed Updates

The oEmbed feature allows your app to embed HTML and basic metadata for public Facebook and Instagram pages, posts, and videos. The oEmbed feature and associated endpoints are designed to help people share posts, including on blogs, websites, and messaging apps.

Today, we’re announcing updates to the oEmbed endpoints for Instagram posts, Facebook posts, and Facebook videos to remove some fields. We are also deprecating the oEmbed endpoint for Facebook page posts.

Developers looking to begin implementing oEmbed functionality can request the new meta_oembed_read feature and will not need to make changes in response to these announcements. For existing developers that already use the existing oembed_read feature, these changes go into effect on October 1, 2025 by by which your app will be automatically updated to the new meta_oembed_read feature.

Instagram oEmbed

The /instagram_oembed endpoint will no longer return the thumbnail_url, thumbnail_width, thumbnail_height, and author_name fields. Since Instagram will no longer return thumbnails through the oEmbed API, we recommend that developers generate their own thumbnails by accessing the HTML metadata directly from the Instagram post used for the oEmbed request.

Sample request

curl -X GET \

"https://graph.facebook.com/v22.0/instagram_oembed?url=https://www.instagram.com/p/fA9uwTtkSN/&access_token=IGQVJ..."

Sample response

{
  "version": "1.0",
  "provider_name": "Instagram",
  "provider_url": "https://www.instagram.com/",
  "type": "rich",
  "width": 658,
  "html": "<blockquote class=\"instagram-media\" data-instgrm-ca..."
}

Facebook Posts and Videos

The /oembed post and /oembed_video endpoints will no longer return the author_name and author_url fields.

Sample request

curl -X GET \
  "https://graph.facebook.com/v22.0/oembed_video?url=www.facebook.com/watch/?v=12…&useiframe=false"

Sample response

{
  "version": "1.0",
  "provider_name": "Facebook",
  "provider_url": "https://www.facebook.com//",
  "height": 500,
  "width": 500,
  "type": "video",
  "html": "<div id="fb-root"></div><script async="1" defer="1" crossorigin="..."
}

For more information and detailed implementation guidelines, please refer to our developer documentation.