AccediInizia la prova gratuita
easyCoexistence API ufficiali

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.

15 May 2026

Da questa data, l'API oEmbed di Instagram di Meta può essere chiamata senza access token, in tutte le versioni.

1,000/hour

Numero di richieste orarie che la guida oEmbed di Meta consente.

320 to 658

L'intervallo che maxwidth accetta; maxheight non è supportato.

3 Nov 2025

author_name, author_url e i campi della miniatura sono stati rimossi dalle risposte oEmbed di Instagram in tutte le versioni dell'API.

Stories

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.

A request and its response
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().
Farlo con EasyCoexistence

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