Instagram-posts op een website insluiten met oEmbed
Het oEmbed-endpoint van Meta, GET /instagram_oembed?url=<POST_URL>, geeft de HTML terug die een openbare Instagram-post of Reel op een webpagina insluit, samen met version, provider_name, provider_url, type en width. Sinds 15 mei 2026 kan het zonder token worden aangeroepen, en de HTML laadt embed.js van Instagram om de post weer te geven.
easyCoexistence geeft via list_social_posts de permalink van elke verbonden Instagram-post terug, klaar om aan oEmbed door te geven, en laat Claude, ChatGPT of je eigen code via de officiële API van Meta posts publiceren, plannen en reageren op reacties en DM's op het account.
Sinds deze datum kan de Instagram oEmbed-API van Meta zonder token worden aangeroepen, in alle versies.
Het aantal verzoeken per uur dat de oEmbed-gids van Meta toestaat.
Het bereik dat maxwidth accepteert; maxheight wordt niet ondersteund.
Het moment waarop author_name, author_url en de thumbnailvelden uit Instagram oEmbed-antwoorden verdwenen in alle API-versies.
Niet ondersteund door het oEmbed-endpoint, evenmin posts van privé-, inactieve of leeftijdsbeperkte accounts.
Hoe werkt het oEmbed-endpoint van Instagram?
Je stuurt de URL van een openbare post en krijgt de HTML terug die die post weergeeft. Het endpoint draait op de hoofd-Graph-API-host van Meta, dezelfde die Facebook Login-aanroepen gebruiken, en niet op graph.instagram.com. Het antwoord is een klein JSON-object waarvan het html-veld onveranderd in de pagina wordt geplaatst.
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>"
}Welke URL's accepteert het?
Drie formaten, zoals Meta's gids ze voor de url-parameter noemt. De URL mag gewoon of URL-gecodeerd worden verzonden; de twee voorbeeldverzoeken in de gids tonen er een van elk:
- Losse afbeeldingsposts en carrousels: https://www.instagram.com/p/{media-shortcode}/
- Video's en Reels: https://www.instagram.com/reel/{media-shortcode}/
- Profielen: https://www.instagram.com/{username}
Heeft het een token nodig?
Niet meer sinds 15 mei 2026, toen de changelog van Meta meldde dat de Instagram oEmbed-API zonder token aanroepbaar werd. Daarvoor hadden apps de functie Meta oEmbed Read nodig via App Review en een token bij elke aanroep, en toegang met token werkt nog steeds. De oEmbed-gids van Meta staat tot 1.000 verzoeken per uur toe, en de aankondiging van Meta over toegang zonder token zei dat apps met token mogelijk hogere limieten krijgen.
Welke parameters neemt het aan?
Vier naast url, uit de gids van Meta en de referentie:
- maxwidth: van 320 tot 658; de insluiting is verder responsief, en maxheight wordt niet ondersteund.
- hidecaption: true verbergt het bijschrift van de post; standaard staat het op false.
- omitscript: true laat het script weg uit de HTML, voor pagina's die embed.js zelf één keer laden en instgrm.Embeds.process() aanroepen.
- fields: beperkt het antwoord tot de genoemde velden.
Wat bevat het antwoord?
Zes standaardvelden: html, de op te tonen markup; version, altijd 1.0; provider_name en provider_url, die Instagram noemen; type, het oEmbed-resourcetype; en width, in pixels. Meta heeft author_name, author_url, thumbnail_url, thumbnail_width en thumbnail_height op 3 november 2025 uit Instagram-postantwoorden verwijderd in alle API-versies. Voor posts op je eigen account retourneert de media-edge nog wel username, permalink en thumbnail_url.
Wat kan niet worden ingesloten?
De gids van Meta noemt wat het endpoint weglaat, en één regel over het gebruik:
- Posts van privé-, inactieve en leeftijdsbeperkte accounts.
- Accounts die insluitingen hebben uitgeschakeld.
- Stories, en pagina's die de insluiting in een Shadow DOM weergeven.
- Elk gebruik buiten een weergave aan de voorkant: Meta verbiedt uitdrukkelijk het gebruik van de metadata of content van het endpoint voor andere doeleinden.
Hoe sluit je de posts van je eigen account in?
Neem de permalink van elke post en geef die door als url. Via easyCoexistence geeft list_social_posts de recente posts van het gekoppelde account met hun permalinks terug, vanuit Claude, ChatGPT of je eigen code, en omdat de oEmbed-aanroep geen token nodig heeft, kan je site die rechtstreeks doen.
Veelgemaakte fouten
- Een Story-link versturen. Het oEmbed-endpoint van Meta ondersteunt geen Stories, dus sluit een post of Reel in.
- De thumbnail_url uit het antwoord lezen. Meta heeft die verwijderd, samen met author_name en de andere thumbnailvelden, op 3 november 2025.
- maxwidth instellen onder 320 of boven 658. Meta accepteert alleen waarden in dat bereik, en helemaal geen maxheight.
- embed.js bij elke insluiting laden. Met omitscript op true laad je het script één keer en roep je instgrm.Embeds.process() aan.
US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan ik een Instagram-Reel insluiten?
Ja. Geef de URL https://www.instagram.com/reel/{media-shortcode}/ door en het endpoint geeft de insluit-HTML terug.
Is de Instagram-insluiting responsief?
Ja. Volgens de gids van Meta is de insluiting responsief, en maxwidth bepaalt de maximale breedte.
Kan ik een Instagram-profiel insluiten?
Ja. De gids van Meta noemt profiel-URL's, https://www.instagram.com/{username}, als een van de formaten die de url-parameter accepteert.
Kan ik oEmbed-gegevens voor analyses gebruiken?
Nee. Meta staat het endpoint alleen toe om de post op een pagina of in een app te tonen, en verbiedt andere gebruiken van de metadata en content.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op