Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Publicar historias de Instagram a través de la API

La API de Instagram publica una historia a partir de una imagen o un video en una URL pública: crea un contenedor con media_type STORIES y luego publícalo. Las imágenes son JPEG de hasta 8 MB, los videos duran de 3 a 60 segundos y pesan hasta 100 MB, Meta recomienda un encuadre 9:16, y la historia desaparece a las 24 horas, igual que en la app.

easyCoexistence publica historias de imagen y video con publish_instagram_post desde Claude, ChatGPT o tu propio código, y puede programarlas desde su propia cola.

60 s

Video de historia más largo que publica la API; el más corto dura 3 segundos y el archivo puede llegar a 100 MB.

8 MB

Imagen de historia más grande, que debe ser un JPEG.

24 hours

Cuánto tiempo permanece publicada una historia antes de expirar.

Under 5

Los valores de métricas de historia tan bajos se devuelven como error 10, espectadores insuficientes, en lugar de un número.

¿Cómo se publica una historia?

Con las mismas dos llamadas que cualquier publicación. POST /<IG_ID>/media con media_type en STORIES y image_url o video_url, y luego POST /<IG_ID>/media_publish con el ID del contenedor. Un video de historia se procesa primero, así que el status_code de su contenedor debe aparecer como FINISHED antes de poder publicarlo.

La referencia de Meta describe el pie de foto para fotos, videos y carruseles, no para historias, así que los textos dirigidos al espectador van dentro de la imagen o del video.

¿Qué requisitos de medios tienen las historias?

Meta recomienda un encuadre 9:16 tanto para imágenes como para videos de historias, para evitar recortes o espacio en blanco.

  • Imagen: JPEG, de hasta 8 MB, en sRGB; otros espacios de color se convierten.
  • Video: MOV o MP4 con video H.264 o HEVC y audio AAC, de 23 a 60 fotogramas por segundo, hasta 1920 píxeles de ancho y 25 Mbps.
  • Duración del video: de 3 a 60 segundos, con un archivo de hasta 100 MB.
  • Relación de aspecto del video: se acepta cualquiera entre 0.1:1 y 10:1.

¿Qué puede llevar una historia?

La imagen o el video en sí, y menciones de otras cuentas: desde julio de 2025, el parámetro user_tags etiqueta cuentas públicas en historias de imagen y video, con coordenadas x e y opcionales. Meta no admite publicar stickers a través de la API, así que los enlaces, encuestas y ubicaciones se quedan en la app.

¿Qué pasa después de publicar una historia?

Permanece activa durante 24 horas y luego expira, igual que en la app. Meta muestra las historias en vivo en un edge de historias separado; la lista de medios de la cuenta, GET /<IG_ID>/media, no las incluye. Al leerla, el media_type de una historia es IMAGE o VIDEO, igual que cualquier otro medio, así que distingue las historias por dónde las encontraste y no por su tipo.

¿Cómo llegan las respuestas y menciones?

Como mensajes directos. Una respuesta a una historia llega a la cuenta como DM en el webhook de mensajes, con el ID y la URL de la historia adjuntos, y abre la ventana habitual de 24 horas para responder. Cuando alguien menciona la cuenta en su propia historia, también llega como mensaje, con un adjunto de tipo story_mention. La Mentions API de Meta no cubre las historias.

¿Qué métricas reporta una historia?

Alcance, vistas, compartidos, respuestas, seguidores nuevos, visitas al perfil, actividad del perfil, navegación, clics en enlaces, republicaciones e interacciones totales, leídos a través del endpoint de insights de medios. Solo están disponibles durante 24 horas, y un valor menor de 5 devuelve el código de error 10, espectadores insuficientes, en lugar de un número. Las respuestas de personas en Europa y Japón se excluyen del conteo, y una historia creada por una cuenta de esas regiones reporta 0 respuestas.

Errores comunes

  • Planear un sticker de enlace. La API no publica stickers, así que un enlace debe llegar a las personas de otra forma, por ejemplo con una respuesta por DM.
  • Leer las métricas de historias al día siguiente. Solo están disponibles durante 24 horas, así que recógelas mientras la historia está activa.
  • Buscar una historia publicada en la lista de medios de la cuenta. Las historias en vivo aparecen en un edge de historias separado.
  • Publicar un video horizontal como historia. Meta recomienda 9:16, y otras formas pueden mostrar espacio en blanco o recortarse.
Hacerlo con EasyCoexistence

Las respuestas a una historia llegan como DMs, que pueden reenviarse a tu endpoint o recibir una respuesta de una automatización. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Puedo añadir un sticker de enlace a una historia a través de la API?

No. Meta no admite publicar stickers a través de la API, incluidos los enlaces, encuestas y ubicaciones. Mencionar otra cuenta sin sticker sí está admitido.

¿Dónde aparece una historia publicada en la API?

En el edge de historias separado de la cuenta mientras está activa. GET /<IG_ID>/media no incluye historias, y una historia se lee como IMAGE o VIDEO.

¿Puede una historia tener pie de foto a través de la API?

No. La referencia de Meta no describe pie de foto para historias, y publish_instagram_post envía una historia sin uno, así que los textos dirigidos al espectador van dentro de la imagen o del video.

¿Cuánto tiempo están disponibles las métricas de historias?

Durante 24 horas. Meta solo las deja disponibles ese tiempo, así que léelas mientras la historia está activa.

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