Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Insertar publicaciones de Instagram en un sitio web con oEmbed

El endpoint oEmbed de Instagram de Meta, GET /instagram_oembed?url=<POST_URL>, devuelve el HTML que inserta en una página web una publicación o Reel de Instagram pública, junto con version, provider_name, provider_url, type y width. Desde el 15 de mayo de 2026 puede llamarse sin token de acceso, y el HTML carga embed.js de Instagram para dibujar la publicación.

easyCoexistence devuelve el permalink de cada publicación de Instagram conectada mediante list_social_posts, listo para pasarlo a oEmbed, y permite que Claude, ChatGPT o tu propio código publiquen, programen y respondan comentarios y mensajes directos en la cuenta mediante la API oficial de Meta.

15 May 2026

Desde esta fecha, la API oEmbed de Instagram de Meta puede llamarse sin token de acceso, en todas las versiones.

1,000/hour

Peticiones por hora que permite la guía de oEmbed de Meta.

320 to 658

El rango que acepta maxwidth; maxheight no es compatible.

3 Nov 2025

Fecha en que author_name, author_url y los campos de miniatura dejaron de aparecer en las respuestas de Instagram oEmbed, en todas las versiones de la API.

Stories

No es compatible con el endpoint oEmbed, ni tampoco las publicaciones de cuentas privadas, inactivas o con restricción de edad.

¿Cómo funciona el endpoint oEmbed de Instagram?

Envías la URL de una publicación pública y recibes el HTML que la muestra. El endpoint funciona en el host principal de la Graph API de Meta, el que usan las llamadas de Facebook Login, en lugar de graph.instagram.com, y la respuesta es un pequeño objeto JSON cuyo campo html se incorpora tal cual a la página.

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>"
}

¿Qué URL acepta?

Tres formatos, tal como los enumera la guía de Meta para el parámetro url, que puede enviarse en texto plano o codificado en URL. Las dos peticiones de ejemplo de la guía muestran uno de cada una:

  • Publicaciones de imagen única y carruseles: https://www.instagram.com/p/{media-shortcode}/
  • Videos y Reels: https://www.instagram.com/reel/{media-shortcode}/
  • Perfiles: https://www.instagram.com/{username}

¿Necesita un token de acceso?

No desde el 15 de mayo de 2026, cuando el registro de cambios (changelog) de Meta indica que la API oEmbed de Instagram pasó a poder llamarse sin uno. Antes, las apps necesitaban la función Meta oEmbed Read mediante App Review y un token en cada llamada, y el acceso con token sigue funcionando. La guía de oEmbed de Meta permite hasta 1.000 peticiones por hora, y el anuncio de Meta sobre el acceso sin token indica que las apps con token pueden obtener límites de tasa más altos.

¿Qué parámetros acepta?

Cuatro además de url, según la guía de Meta y su referencia:

  • maxwidth: de 320 a 658; por lo demás el embed es adaptable, y maxheight no es compatible.
  • hidecaption: true oculta el pie de foto de la publicación; por defecto es false.
  • omitscript: true deja el script fuera del HTML, para páginas que cargan embed.js una vez por su cuenta y llaman a instgrm.Embeds.process().
  • fields: limita la respuesta a los campos indicados.

¿Qué contiene la respuesta?

Seis campos por defecto: html, el marcado que se muestra; version, siempre 1.0; provider_name y provider_url, que identifican a Instagram; type, el tipo de recurso oEmbed; y width, en píxeles. Meta eliminó author_name, author_url, thumbnail_url, thumbnail_width y thumbnail_height de las respuestas de publicaciones de Instagram en todas las versiones de la API el 3 de noviembre de 2025. En las publicaciones de tu propia cuenta, el edge media sigue devolviendo username, permalink y thumbnail_url.

¿Qué no se puede insertar?

La guía de Meta enumera lo que el endpoint deja fuera, y una regla de uso:

  • Publicaciones de cuentas privadas, inactivas y con restricción de edad.
  • Cuentas que han desactivado los embeds.
  • Historias, y páginas que muestran el embed dentro de un Shadow DOM.
  • Cualquier uso más allá de la vista en el front-end: Meta prohíbe estrictamente usar los metadatos o el contenido del endpoint para otros fines.

¿Cómo insertas las publicaciones de tu propia cuenta?

Toma el permalink de cada publicación y pásalo como url. Con easyCoexistence, list_social_posts devuelve las publicaciones recientes de la cuenta conectada con sus permalinks, desde Claude, ChatGPT o tu propio código, y como la llamada a oEmbed no necesita token, tu sitio puede hacerla directamente.

Errores comunes

  • Enviar un enlace de Historia. El endpoint oEmbed de Meta no admite Historias, así que inserta una publicación o un Reel.
  • Leer thumbnail_url de la respuesta. Meta lo eliminó, junto con author_name y los demás campos de miniatura, el 3 de noviembre de 2025.
  • Definir maxwidth por debajo de 320 o por encima de 658. Meta solo acepta valores en ese rango, y no existe ningún maxheight.
  • Cargar embed.js con cada embed. Con omitscript en true, carga el script una sola vez y llama a instgrm.Embeds.process().
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, con un precio que baja a medida que añades conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Puedo insertar un Reel de Instagram?

Sí. Pasa su URL https://www.instagram.com/reel/{media-shortcode}/ y el endpoint devuelve el HTML del embed.

¿El embed de Instagram es adaptable?

Sí. La guía de Meta indica que el embed es adaptable, y maxwidth define el ancho máximo que puede tener.

¿Puedo insertar el perfil de Instagram?

Sí. La guía de Meta incluye las URL de perfil, https://www.instagram.com/{username}, entre los formatos que acepta el parámetro url.

¿Puedo usar los datos de oEmbed para analítica?

No. Meta solo permite el endpoint para mostrar la publicación en una página o en una app, y prohíbe otros usos de sus metadatos y contenido.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el