The oEmbed feature enables apps to embed HTML and metadata for public Facebook and Instagram content, facilitating sharing on blogs, websites, and messaging apps. Recent updates to the oEmbed endpoints for Instagram posts, Facebook posts, and Facebook videos involve the removal of certain fields and the deprecation of the oEmbed endpoint for Facebook page posts.
Developers can implement the new meta_oembed_read feature without needing to adjust their existing setups. Changes will take effect on October 1, 2025, when existing apps will automatically transition to the new feature.
Instagram oEmbed
The /instagram_oembed endpoint will no longer provide the fields: thumbnail_url, thumbnail_width, thumbnail_height, and author_name. Developers are advised to create their own thumbnails by accessing HTML metadata directly from the Instagram post.
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 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 further details and implementation guidelines, refer to the developer documentation.
