Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Límites del caption de Instagram: caracteres, hashtags y etiquetas @ en la API

La API de Instagram publica un caption de hasta 2,200 caracteres con una foto, un Reel o un carrusel, con un máximo de 20 etiquetas @. A noviembre de 2026, el Centro de ayuda de Instagram permite 5 hashtags por publicación, mientras que la referencia de la API de Meta todavía indica 30, así que conviene quedarse en 5. Las cuentas mencionadas con @ reciben una notificación cuando se publica, y un caption demasiado largo falla con el código 36004 y el subcódigo 2207010.

easyCoexistence publica una foto, un carrusel o un Reel con su caption mediante publish_instagram_post, desde Claude, ChatGPT o tu propio código, fijando el caption una sola vez en un carrusel, y list_social_posts lee de vuelta el caption de cada publicación.

2,200

La cantidad máxima de caracteres que puede tener un caption a través de la API de Instagram.

5

Máximo de hashtags que el Centro de Ayuda de Instagram permite ahora en una publicación, en el caption o en los comentarios.

30

Máximo de hashtags por caption en la referencia de la API de Meta, que todavía muestra la cifra anterior.

20

Máximo de etiquetas @ en un caption; si se supera, devuelve el código 100 y el subcódigo 2207040.

2207010

Subcódigo de error, bajo el código 36004, para un caption más largo de lo que permite Instagram.

Partial

media_publish puede tener éxito con config_issue igual a CAPTION_NOT_ATTACHED: la publicación queda en línea sin su caption.

¿Cuáles son los límites del caption?

Tres, todos en el parámetro caption del contenedor de medios. Un caption puede incluir hashtags, escritos como #etiqueta, y nombres de usuario de cuentas de Instagram, escritos como @usuario, dentro de estos límites:

  • Longitud: hasta 2,200 caracteres.
  • Hashtags: hasta 5 por publicación según el Centro de ayuda de Instagram, contando los de los comentarios; la referencia de la API de Meta todavía indica 30.
  • Etiquetas @: hasta 20, y cada cuenta mencionada recibe una notificación cuando se publica el contenido.

¿Qué publicaciones admiten caption?

Fotos, Reels y carruseles. En un carrusel el caption va en el contenedor del carrusel, ya que las imágenes y los videos que contiene no admiten uno, y la referencia de Meta no describe caption para las historias, así que el texto pensado para una historia debe ir en la propia imagen o video.

¿Qué pasa cuando un caption supera un límite?

La petición falla con un error que nombra el problema. Un caption demasiado largo devuelve el código 36004 y el subcódigo 2207010, y la solución de Meta para este error repite los límites: como máximo 2,200 caracteres, 30 hashtags y 20 etiquetas @. Más de 20 etiquetas @ también puede devolver el código 100 y el subcódigo 2207040. Acorta el caption y envía la petición de nuevo.

¿Cuándo se notifica a las cuentas mencionadas?

Cuando se publica el contenedor, no cuando se crea. Las cuentas mencionadas con @ en un caption reciben la notificación en ese momento, así que un contenedor preparado con antelación no avisa a nadie hasta que se publica. El límite de Meta de 20 etiquetas @ por caption se aplica a estas menciones.

¿Puede publicarse una publicación sin su caption?

Sí. media_publish puede tener éxito con config_issue igual a CAPTION_NOT_ATTACHED, lo que significa que el contenido se publicó sin su caption. Meta lo llama éxito parcial: el ID del medio es válido, así que concilia la publicación en lugar de publicarla de nuevo.

¿Se puede cambiar el caption después de publicar?

La referencia de medios de Meta documenta una sola actualización para medios publicados: activar o desactivar los comentarios con POST /<IG_MEDIA_ID> y comment_enabled. No indica ninguna forma de editar un caption, así que revisa el texto, los hashtags y las etiquetas @ antes de crear el contenedor.

Errores comunes

  • Comprobar solo la longitud. Un caption de menos de 2,200 caracteres sigue incumpliendo los límites con más de 5 hashtags, la regla actual de Instagram, o con más de 20 etiquetas @.
  • Poner caption a los elementos de un carrusel. Solo el contenedor del carrusel admite caption.
  • Escribir un caption para una historia. El contenedor de historias no admite ninguno, así que pon el texto en la imagen o en el video.
  • Publicar de nuevo tras CAPTION_NOT_ATTACHED. La primera publicación ya está en línea y una segunda publicación crea un duplicado.
Hacerlo con EasyCoexistence

Desde US$ 9 hasta US$ 0.75 por conexión al mes, que baja al añadir conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué significa el error 2207040 de Instagram?

El caption tiene más de 20 etiquetas @, devuelto bajo el código 100. Elimina etiquetas hasta que queden 20 o menos y envía la petición de nuevo.

¿El límite de 5 hashtags de Instagram incluye los hashtags de los comentarios?

Sí. El Centro de Ayuda de Instagram permite hasta 5 hashtags por publicación, contando los del caption y los de los comentarios.

¿Puedo desactivar los comentarios de una publicación ya publicada a través de la API?

Sí. POST /<IG_MEDIA_ID> con comment_enabled en false desactiva los comentarios, y en true los vuelve a activar; es la única actualización que la referencia de medios de Meta documenta para medios publicados.

¿Qué significa el error 2207010?

El caption es más largo de lo que permite Instagram. Acórtalo a 2,200 caracteres o menos y envía la petición de nuevo.

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