API de Código para insertar una publicación de Instagram

Obtén el código de inserción oEmbed de Instagram de una publicación o Reel a partir de su url: html se muestra como la tarjeta oficial al pegarlo en una página, con author_name y thumbnail_url incluidos, por $0.56 por cada 1000 llamadas.

  • html es el código de inserción para tu página
  • hidecaption controla si se muestra el texto
  • maxwidth limita el ancho de la tarjeta

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "oembed",
      "params": {
        "url": "https://www.instagram.com/p/DbYmqpplO_N/"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "author_name": "n•••a",
        "version": "1.0",
        "type": "rich",
        "title": "The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎\n\nOn Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us!\n\n…",
        …
      }
    }
  3. 3Campos

    author_nameversiontypetitle
    n•••a1.0richThe Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎 On Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us! …
  4. 4CSV

    instagram-oembed-sample.csv version,type,title,author_name,author_url,author_id,media_id,provider_name,provider_url,width,html,thumbnail_url,thumbnail_width,thumbnail_height,shortcode,url,platform

La solicitud lleva el url de la publicación y los opcionales hidecaption y maxwidth, y devuelve un objeto JSON. html es el código de inserción, con author_name, thumbnail_url y más, listo como tabla de campos o CSV.

Qué datos obtienes

La tabla muestra una llamada real para instagram.com/p/DbYmqpplO_N, capturada el 21 de noviembre de 2026, 07:18 (UTC), que devolvió un objeto. Las barras grises tapan datos personales que se quitaron (••• en el CSV). Tus llamadas devuelven los campos de la referencia de campos.

versiontypetitleauthor_nameauthor_urlauthor_idmedia_idprovider_nameprovider_urlwidthhtmlthumbnail_urlthumbnail_widththumbnail_heightshortcodeurlplatform
1.0richThe Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎 On Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us! …n•••ainstagram.com/3952078729724096461_528817151Instagramhttps://www.instagram.com540<blockquote class="instagram-media" data-instgrm-captioned data-instgrm-permalink="https://www.instagram.com/reel/DbYmqpplO_N/?utm_source=ig_embed&amp;utm_campaign=loading" data-instgrm-version="14" style=" background:#FFF; border:0; border-radius:3px; box-shadow:0 0 1px 0 rgba(0…https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/760192799_18631809481049152_7782886010573196119_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ig_cache_key=Mzk1MjA3ODcyOTcyNDA5NjQ2MTE4NjMxODA5NDc1MDQ5MTUy.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3…10801920DbYmqpplO_Nhttps://www.instagram.com/reel/DbYmqpplO_N/instagram

Casos de uso

  • Muestra una publicación en una página web

    Pega html en un blog o en un gestor de contenidos y la página muestra la tarjeta de inserción de Instagram.

  • Muestra la tarjeta sin texto

    Pon hidecaption en true y la tarjeta de inserción no muestra el texto de la publicación.

  • Ajusta el diseño de la página

    Usa maxwidth para limitar el ancho de la tarjeta y maqueta la página con width.

  • Crea una vista previa de enlace

    Lee thumbnail_url, author_name y title para dar a un enlace de publicación una miniatura y el nombre del autor.

Instagram oEmbed frente a EveryInfra

Comparación entre el oEmbed de Instagram de Meta y oembed de EveryInfra: publicaciones admitidas, código de inserción, ancho máximo y publicaciones no admitidas.

AspectoInstagram oEmbedEveryInfra
Publicaciones admitidas"Supports photo, video, Reel, and Feed posts."url admite el enlace de una publicación o Reel (forma /p/ o /reel/).
El código de inserción"The embed HTML will be assigned to the html property."html es el código de inserción, igual que en el oEmbed oficial de Instagram. La respuesta trae además author_name, thumbnail_url, shortcode y más.
Ancho máximo"You can set the maximum width by including the maxwidth query string parameter in your request."maxwidth es un entero de 320 a 658 en píxeles y por defecto vale 540.
Publicaciones no admitidas"Posts on private, inactive, and age-restricted Instagram accounts are not supported."Si la publicación no existe o no se puede ver, la llamada devuelve un resultado vacío sin cobro.

Las citas proceden de la documentación para desarrolladores de Meta, que muestra fecha de actualización 2026-05-15, comprobadas el 2026-11-22. Fuentes oficiales: Embed an Instagram Post (actualizada el 2026-05-15)

Límites y detalles a tener en cuenta

  • url es obligatorio: el enlace de una publicación o Reel.
  • Con hidecaption en true, la tarjeta de inserción no muestra el texto de la publicación. Por defecto es false.
  • maxwidth es un entero de 320 a 658. Por defecto vale 540.
  • Si la publicación no existe o no se puede ver, la llamada devuelve un resultado vacío sin cobro.

Precios

Cada llamada cuesta $0.000556, sea cual sea el número de campos, y devuelve el código de inserción de una publicación. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$5.56
100,000$55.56
1,000,000$555.56

Los totales usan el precio de lista por llamada.

Ejemplos de código

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "oembed",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Referencia de API

Consulta los parámetros, los campos de respuesta, los errores y la facturación de oembed, y copia la página o ábrela como Markdown para un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Instagram: Código para insertar una publicación (instagram/oembed).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en instagram y action en oembed, y los parámetros dentro de params.
- Parámetros obligatorios:
  - url: Enlace de una publicación o Reel, como https://www.instagram.com/p/<shortcode>/ o https://www.instagram.com/reel/<shortcode>/.
- Parámetros opcionales:
  - hidecaption: true oculta el texto de la publicación en la inserción. Por defecto false.
  - maxwidth: Ancho máximo de la inserción en píxeles, un entero de 320 a 658. Por defecto 540.
- Devuelve un objeto. Campos principales: version ((oembed) Versión de oEmbed, 1.0), type, title, author_name, author_url, author_id, media_id (ID numérico de la publicación), provider_name ((oembed) Siempre Instagram), provider_url ((oembed) Siempre https://www.instagram.…), width (Ancho de la imagen o el video original,…), html ((oembed) Código para insertar: un block…), thumbnail_url; 16 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "oembed",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSíinstagramIdentificador de la plataforma, valor fijo.
actionbodystringSíoembedIdentificador de la capacidad, valor fijo.
urlbody.paramsstringSí-Enlace de una publicación o Reel, como https://www.instagram.com/p/<shortcode>/ o https://www.instagram.com/reel/<shortcode>/.
hidecaptionbody.paramsbooleanNo-true oculta el texto de la publicación en la inserción. Por defecto false.
maxwidthbody.paramsintegerNo-Ancho máximo de la inserción en píxeles, un entero de 320 a 658. Por defecto 540.

Ejemplo de respuesta

#
Obtenida el 21 de noviembre de 2026, 07:18 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "instagram",  "action": "oembed",  "results": {    "version": "1.0",    "type": "rich",    "title": "The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎\n\nOn Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us!\n\n…",    "author_name": "n•••a",    "author_url": "https://www.instagram.com/•••",    "author_id": "•••",    "media_id": "3952078729724096461_528817151",    "provider_name": "Instagram",    "provider_url": "https://www.instagram.com",    "width": 540,    "html": "<blockquote class=\"instagram-media\" data-instgrm-captioned data-instgrm-permalink=\"https://www.instagram.com/reel/DbYmqpplO_N/?utm_source=ig_embed&amp;utm_campaign=loading\" data-instgrm-version=\"14\" style=\" background:#FFF; border:0; border-radius:3px; box-shadow:0 0 1px 0 rgba(0…",    "thumbnail_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/760192799_18631809481049152_7782886010573196119_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ig_cache_key=Mzk1MjA3ODcyOTcyNDA5NjQ2MTE4NjMxODA5NDc1MDQ5MTUy.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3…",    "thumbnail_width": 1080,    "thumbnail_height": 1920,    "shortcode": "DbYmqpplO_N",    "url": "https://www.instagram.com/reel/DbYmqpplO_N/",    "platform": "instagram"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
version(oembed) Versión de oEmbed, 1.0.
typeTipo de registro; los valores dependen de la capacidad (por ejemplo video / image / text).
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
author_nameNombre visible del autor.
author_urlEnlace al perfil del autor en la plataforma.
author_idIdentificador único del autor en la plataforma.
media_idID numérico de la publicación. oembed lo da como IDpublicación_IDautor.
provider_name(oembed) Siempre Instagram.
provider_url(oembed) Siempre https://www.instagram.com.
widthAncho de la imagen o el video original, en píxeles.
html(oembed) Código para insertar: un blockquote más el embed.js de Instagram que muestra la tarjeta oficial.
thumbnail_urlEnlace a la miniatura, con menos resolución que image_url.
thumbnail_width(oembed) Ancho de la miniatura en píxeles.
thumbnail_height(oembed) Alto de la miniatura en píxeles.
shortcodeShortcode de la publicación: la parte del enlace después de /p/ o /reel/.
urlEnlace al registro en la plataforma.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Preguntas frecuentes

¿Qué devuelve el endpoint de código de inserción de Instagram?

Los mismos campos y el mismo código de inserción que el oEmbed oficial de Instagram: html, author_name, author_url, thumbnail_url, width, shortcode, url y más.

¿Cómo inserto una publicación en una página web?

Envía el url de la publicación y pega el html de la respuesta en la página. Se muestra como la tarjeta de inserción de Instagram.

¿Cuánto cuesta un código de inserción?

Se cobra por llamada: $0.000556 cada una, o $0.56 por cada 1000 llamadas. Las llamadas fallidas y los resultados vacíos no se cobran.

¿Tengo que iniciar sesión en Instagram para obtener un código de inserción?

No. Pon tu clave de API de EveryInfra en la cabecera Authorization: Bearer; no necesitas iniciar sesión en Instagram ni un token de acceso.

¿En qué se diferencian oembed y post?

oembed devuelve html para insertar y datos básicos. post lee los datos de contenido de una publicación, como el texto, los «me gusta» y los comentarios.

La misma clave de API de EveryInfra sirve para las demás capacidades de Instagram, por ejemplo post, que lee el contenido de una publicación a partir de su enlace.

Google Analytics solo si aceptas. Privacidad