Încorporarea postărilor Instagram pe un site cu oEmbed
Endpoint-ul Instagram oEmbed al Meta, GET /instagram_oembed?url=<POST_URL>, returnează codul HTML care încorporează pe o pagină web o postare sau un Reel Instagram public, împreună cu version, provider_name, provider_url, type și width. Din 15 mai 2026 poate fi apelat fără token de acces, iar HTML-ul încarcă embed.js de la Instagram pentru a afișa postarea.
easyCoexistence returnează permalink-ul fiecărei postări Instagram conectate prin list_social_posts, gata de transmis către oEmbed, și permite lui Claude, ChatGPT sau propriului cod să publice, să programeze și să răspundă la comentarii și mesaje directe (DM) pe cont, prin API-ul oficial al Meta.
Din această dată, API-ul oEmbed Instagram al Meta poate fi apelat fără token de acces, în toate versiunile.
Numărul de cereri pe oră pe care le permite ghidul oEmbed al Meta.
Intervalul acceptat de maxwidth; maxheight nu este suportat.
Din această dată, câmpurile author_name, author_url și cele pentru miniatură au dispărut din răspunsurile oEmbed Instagram, în toate versiunile API.
Nu sunt acceptate de endpoint-ul oEmbed, nici postările din conturi private, inactive sau cu restricție de vârstă.
Cum funcționează endpoint-ul oEmbed al Instagram?
Trimiteți URL-ul unei postări publice și primiți înapoi codul HTML care o afișează. Endpoint-ul rulează pe gazda principală Graph API a Meta, cea folosită și de apelurile Facebook Login, nu pe graph.instagram.com, iar răspunsul este un obiect JSON mic al cărui câmp html se introduce în pagină exact așa cum este.
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>"
}Ce URL-uri acceptă?
Trei formate, așa cum le enumeră ghidul Meta pentru parametrul url, care poate fi trimis simplu sau codificat URL; cele două exemple de cereri din ghid arată câte unul dintre fiecare:
- Postări cu imagine unică și carusel: https://www.instagram.com/p/{media-shortcode}/
- Videoclipuri și Reel-uri: https://www.instagram.com/reel/{media-shortcode}/
- Profiluri: https://www.instagram.com/{username}
Are nevoie de token de acces?
Nu din 15 mai 2026, când changelog-ul Meta arată că API-ul oEmbed Instagram a devenit apelabil fără token. Înainte, aplicațiile aveau nevoie de funcția Meta oEmbed Read, aprobată prin App Review, și de un token la fiecare apel, iar accesul bazat pe token funcționează în continuare. Ghidul oEmbed al Meta permite până la 1.000 de cereri pe oră, iar anunțul Meta despre accesul fără token spune că aplicațiile cu token pot primi limite de rată mai mari.
Ce parametri primește?
Patru în afara lui url, din ghidul Meta și din referința sa:
- maxwidth: de la 320 la 658; altfel încorporarea este responsivă, iar maxheight nu este suportat.
- hidecaption: true ascunde legenda postării; implicit este false.
- omitscript: true lasă scriptul în afara HTML-ului, pentru paginile care încarcă embed.js o singură dată și apelează instgrm.Embeds.process().
- fields: limitează răspunsul la câmpurile numite.
Ce conține răspunsul?
Șase câmpuri implicite: html, marcajul de afișat; version, întotdeauna 1.0; provider_name și provider_url, care numesc Instagram; type, tipul resursei oEmbed; și width, în pixeli. Meta a eliminat author_name, author_url, thumbnail_url, thumbnail_width și thumbnail_height din răspunsurile pentru postările Instagram, în toate versiunile API, pe 3 noiembrie 2025. Pentru postările din propriul cont, edge-ul media returnează în continuare username, permalink și thumbnail_url.
Ce nu poate fi încorporat?
Ghidul Meta enumeră ce lasă endpoint-ul în afară și o regulă de utilizare:
- Postări de pe conturi private, inactive și cu restricție de vârstă.
- Conturi care au dezactivat încorporările.
- Story-urile și paginile care afișează încorporarea într-un Shadow DOM.
- Orice utilizare dincolo de o vizualizare front-end: Meta interzice strict folosirea metadatelor sau a conținutului endpoint-ului în alte scopuri.
Cum încorporați postările propriului cont?
Luați permalink-ul fiecărei postări și transmiteți-l ca url. Prin easyCoexistence, list_social_posts returnează postările recente ale contului conectat, cu permalink-urile lor, de la Claude, ChatGPT sau din propriul cod, iar pentru că apelul oEmbed nu are nevoie de token, site-ul dumneavoastră îl poate face direct.
Greșeli frecvente
- Trimiterea unui link de Story. Endpoint-ul oEmbed al Meta nu acceptă Story-urile, așadar încorporați o postare sau un Reel.
- Citirea thumbnail_url din răspuns. Meta l-a eliminat, împreună cu author_name și celelalte câmpuri pentru miniatură, pe 3 noiembrie 2025.
- Setarea maxwidth sub 320 sau peste 658. Meta acceptă valori doar în acest interval și niciun maxheight.
- Încărcarea embed.js la fiecare încorporare. Cu omitscript setat la true, încărcați scriptul o singură dată și apelați instgrm.Embeds.process().
De la US$ 9 la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Pot încorpora un Reel Instagram?
Da. Transmiteți URL-ul său https://www.instagram.com/reel/{media-shortcode}/, iar endpoint-ul returnează codul HTML de încorporare.
Încorporarea Instagram este responsivă?
Da. Ghidul Meta spune că încorporarea este responsivă, iar maxwidth stabilește cea mai mare lățime pe care o poate avea.
Pot încorpora un profil Instagram?
Da. Ghidul Meta enumeră URL-urile de profil, https://www.instagram.com/{username}, printre formatele acceptate de parametrul url.
Pot folosi datele oEmbed pentru analiză?
Nu. Meta permite endpoint-ul doar pentru afișarea postării pe o pagină sau într-o aplicație și interzice alte utilizări ale metadatelor și conținutului său.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la