You can query the Instagram oEmbed endpoint to get an Instagram post’s embed HTML and basic metadata in order to display the post in another website or app. Supports photo, video, Reel, and Feed posts.
Visit the Instagram Help Center to learn how to get the embed code from a public Instagram post or profile.
This guide assumes you are a registered Meta developer and have created a Meta app.
You will need the following:
for the oEmbed Read feature – Requires
Meta App ReviewAll endpoints can be accessed via the graph.facebook.com
host.
Rate limits are dependent on the type of access token your app includes in each request.
Apps that rely on app access tokens can make up to 5 million requests per 24 hours.
Client token rate limits are significantly lower than app token rate limits. We do not reveal the actual limit as it will change depending on your app activity. However, you can safely assume that your app will not reach its limit unless it exhibits bot-like behavior, such as batching thousands of requests, or sending thousands of requests per agent or app user.
You can get an embed HTML programmatically or in the Instagram app.
To programmatically get an Intagram post's embed HTML, send a request to:
GET /instagram_oembed?url=<URL_OF_THE_POST>&access_token=<ACCESS_TOKEN>
Replace <URL_OF_THE_POST>
with the URL of the Instagram post that you want to query and <ACCESS_TOKEN>
with your app or client access token or pass it to us in an Authorization
HTTP header.
Authorization: Bearer <ACCESS_TOKEN>
If you are using a client access token, remember that you must combine it with your Meta App ID using a pipe symbol otherwise the request will fail.
Upon success, the API will respond with a JSON object containing the post's embed HTML and additional data. The embed HTML will be assigned to the html
property.
Refer to the Instagram oEmbed reference for a list of query string parameters you can include to augment the request. You may also include the fields
query string parameter to specify which fields you want returned. If omitted, all default Fields will be included in the response.
curl -X GET \
"https://graph.facebook.com/v21.0
/instagram_oembed?url=https://www.instagram.com/p/fA9uwTtkSN/&access_token=IGQVJ..."
curl -i -X GET \
--header "Authorization: Bearer 96481..." \
"https://graph.facebook.com/v21.0
/instagram_oembed?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FfA9uwTtkSN"
Some values truncated with an ellipsis (...
) for readability.
{ "version": "1.0", "author_name": "diegoquinteiro", "provider_name": "Instagram", "provider_url": "https://www.instagram.com/", "type": "rich", "width": 658, "html": "<blockquote class=\"instagram-media\" data-instgrm-ca...", "thumbnail_width": 640, "thumbnail_height": 640 }
The url
query string parameter accepts the following URL formats:
https://www.instagram.com/p/{media-shortcode}/
https://www.instagram.com/tv/{media-shortcode}/
https://www.instagram.com/{username}/guide/{slug}/{guide_id}
The embed HTML contains a reference to the Instagram embed.js JavaScript library. When the library loads, it scans the page for the post HTML and generates the fully rendered post. If you want to load the library separately, include the omitscript=true
query string parameter in your request. To manually initialize the embed HTML, call the instgrm.Embeds.process()
function after loading the library.
The embedded post is responsive and will adapt to the size of its container. This means that the height will vary depending on the container width and the length of the caption. You can set the maximum width by including the maxwidth
query string parameter in your request.
We recommend that you render all of the post’s embed HTML whenever possible. If you are unable to do this, you can get a post’s thumbnail image URL and render that instead. If you do this, however, you must provide clear attribution next to the image, including attribution to the original author and to Instagram, and a link to the Instagram post that you are querying.
To get a post’s thumbnail URL and attribution information, send a request to:
GET /instagram_oembed ?url=<URL_OF_THE_POST> &maxwidth=<MAX_WIDTH> &fields=thumbnail_url,author_name,provider_name,provider_url &access_token=<ACCESS_TOKEN>
Replace <URL_OF_THE_POST>
with the URL of the Instagram post you want to query, <MAX_WIDTH>
with the maximum size of the thumbnail you want to render, and <ACCESS_TOKEN>
with your app or client access token.
curl -i -X GET \
"https://graph.facebook.com/v21.0
/instagram_oembed?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FfA9uwTtkSN&maxwidth=320&fields=thumbnail_url%2Cauthor_name%2Cprovider_name%2Cprovider_url&access_token=96481..."
Some values truncated with an ellipsis (...
) for readability.
{ "thumbnail_url": "https://scontent.cdninstagram.com/v/t51.288...", "author_name": "diegoquinteiro", "provider_name": "Instagram", "provider_url": "https://www.instagram.com/" }
When you submit your app for review, in the Tell Us Why You're Requesting Oembed Read > Please provide a URL where we can test Oembed Read form field, use the Instagram oEmbed endpoint to get the embed HTML for any public post on our official Facebook Page or Instagram Page. Then, add the returned embed HTML to where you will be displaying oEmbed content and enter that page's URL in the form field.
Once you have been approved for the oEmbed Read feature you may embed your own pages, posts, or videos using their respective URLs.