Incorporare post di Instagram in un sito con oEmbed
L'endpoint oEmbed di Instagram di Meta, GET /instagram_oembed?url=<POST_URL>, restituisce l'HTML che incorpora in una pagina web un post o un Reel pubblico di Instagram, insieme a version, provider_name, provider_url, type e width. Dal 15 maggio 2026 può essere chiamato senza access token, e l'HTML carica embed.js di Instagram per disegnare il post.
easyCoexistence restituisce il permalink di ogni post Instagram collegato tramite list_social_posts, pronto da passare a oEmbed, e permette a Claude, ChatGPT o al tuo codice di pubblicare, programmare e rispondere a commenti e DM sull'account tramite l'API ufficiale di Meta.
Da questa data, l'API oEmbed di Instagram di Meta può essere chiamata senza access token, in tutte le versioni.
Numero di richieste orarie che la guida oEmbed di Meta consente.
L'intervallo che maxwidth accetta; maxheight non è supportato.
author_name, author_url e i campi della miniatura sono stati rimossi dalle risposte oEmbed di Instagram in tutte le versioni dell'API.
Non supportati dall'endpoint oEmbed, così come i post di account privati, inattivi o con limiti d'età.
Come funziona l'endpoint oEmbed di Instagram?
Invii l'URL di un post pubblico e ricevi l'HTML che lo mostra. L'endpoint gira sull'host principale della Graph API di Meta, quello usato dalle chiamate di Facebook Login, anziché su graph.instagram.com, e la risposta è un piccolo oggetto JSON il cui campo html va inserito così com'è nella pagina.
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>"
}Quali URL accetta?
Tre formati, come la guida di Meta elenca per il parametro url, che può essere inviato in chiaro o codificato in URL; le due richieste di esempio della guida ne mostrano uno per tipo:
- Post con immagine singola e carosello: https://www.instagram.com/p/{media-shortcode}/
- Video e Reel: https://www.instagram.com/reel/{media-shortcode}/
- Profili: https://www.instagram.com/{username}
Serve un access token?
No dal 15 maggio 2026, quando il changelog di Meta dice che l'API oEmbed di Instagram è diventata richiamabile senza. Prima, le app avevano bisogno della funzione Meta oEmbed Read tramite App Review e di un token in ogni chiamata, e l'accesso con token funziona ancora. La guida oEmbed di Meta consente fino a 1.000 richieste all'ora, e l'annuncio di Meta sull'accesso senza token dice che le app con token possono ottenere limiti di frequenza più alti.
Quali parametri accetta?
Quattro oltre a url, dalla guida di Meta e dal suo riferimento:
- maxwidth: da 320 a 658; altrimenti l'embed è responsive, e maxheight non è supportato.
- hidecaption: true nasconde la didascalia del post; di default è false.
- omitscript: true lascia lo script fuori dall'HTML, per le pagine che caricano embed.js una sola volta da sé e chiamano instgrm.Embeds.process().
- fields: limita la risposta ai campi indicati.
Cosa contiene la risposta?
Sei campi predefiniti: html, il markup da mostrare; version, sempre 1.0; provider_name e provider_url, che indicano Instagram; type, il tipo di risorsa oEmbed; e width, in pixel. Il 3 novembre 2025 Meta ha rimosso author_name, author_url, thumbnail_url, thumbnail_width e thumbnail_height dalle risposte dei post di Instagram in tutte le versioni dell'API. Per i post del tuo account, l'edge media restituisce ancora username, permalink e thumbnail_url.
Cosa non può essere incorporato?
La guida di Meta elenca ciò che l'endpoint esclude, e una regola sull'uso:
- Post di account privati, inattivi e con restrizioni d'età.
- Account che hanno disattivato gli embed.
- Storie, e pagine che mostrano l'embed dentro uno Shadow DOM.
- Qualsiasi uso oltre la visualizzazione sul front-end: Meta vieta rigorosamente di usare i metadati o i contenuti dell'endpoint per altri scopi.
Come incorpori i post del tuo account?
Prendi il permalink di ogni post e passalo come url. Tramite easyCoexistence, list_social_posts restituisce i post recenti dell'account collegato con i rispettivi permalink, da Claude, ChatGPT o dal tuo codice, e poiché la chiamata oEmbed non richiede token, il tuo sito può farla direttamente.
Errori comuni
- Inviare il link di una Storia. L'endpoint oEmbed di Meta non supporta le Storie, quindi incorpora un post o un Reel.
- Leggere thumbnail_url dalla risposta. Meta l'ha rimosso, insieme ad author_name e agli altri campi della miniatura, il 3 novembre 2025.
- Impostare maxwidth sotto 320 o sopra 658. Meta accetta solo valori in quell'intervallo, e nessun maxheight.
- Caricare embed.js con ogni embed. Con omitscript impostato su true, carica lo script una sola volta e chiama instgrm.Embeds.process().
Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Posso incorporare un Reel di Instagram?
Sì. Passa il suo URL https://www.instagram.com/reel/{media-shortcode}/ e l'endpoint restituisce l'HTML dell'embed.
L'embed di Instagram è responsive?
Sì. La guida di Meta dice che l'embed è responsive, e maxwidth ne imposta la larghezza massima.
Posso incorporare un profilo Instagram?
Sì. La guida di Meta elenca gli URL dei profili, https://www.instagram.com/{username}, tra i formati che il parametro url accetta.
Posso usare i dati oEmbed per le analisi?
No. Meta consente l'endpoint solo per mostrare il post su una pagina o in un'app, e vieta altri usi dei suoi metadati e contenuti.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il