Límites de publicación de la API de Instagram: formatos, tamaños y publicaciones al día
El límite de publicación de la API de Instagram es de 100 publicaciones por cuenta profesional en 24 horas móviles, y un carrusel cuenta como una. Cada publicación admite una imagen JPEG de hasta 8 MB, un carrusel de hasta 20 elementos, un Reel de 3 segundos a 15 minutos o una Historia con hasta 60 segundos de video, que Meta obtiene desde una URL pública, y los pies de foto llegan a 2,200 caracteres.
easyCoexistence publica fotos, carruseles de 2 a 10 elementos, Reels e Historias con publish_instagram_post, desde Claude, ChatGPT o tu propio código, termina por su cuenta un video que aún se está procesando y programa las publicaciones desde su propia cola.
Publicaciones hechas por API por cuenta en 24 horas móviles; un carrusel cuenta como una sola publicación.
Imagen JPEG más grande que admite la API, con una relación de aspecto entre 4:5 y 1.91:1.
Contenedores de medios que una cuenta puede crear en 24 horas móviles.
Tiempo que un contenedor de medios puede esperar sin publicarse antes de caducar.
Caracteres permitidos en un pie de foto, con un máximo de 20 etiquetas @, según la referencia de medios de Meta.
La mayor cantidad de hashtags que permite el Centro de ayuda de Instagram en una publicación.
¿Qué se puede publicar a través de la API?
Cuatro formatos, y cada uno pasa por las mismas dos llamadas: crear un contenedor de medios a partir del archivo y luego publicar ese contenedor.
- Foto: una imagen JPEG, con pie de foto.
- Carrusel: hasta 20 fotos y videos juntos en una publicación, con un único pie de foto para el carrusel.
- Reel: un video MOV o MP4, con pie de foto.
- Historia: una imagen o un video, visible durante 24 horas.
¿Cuántas publicaciones puede hacer una cuenta al día?
100 por API en 24 horas móviles, contando un carrusel una vez. Instagram aplica el límite cuando se publica un contenedor y no cuando se crea, así que una publicación por encima del límite falla en ese momento, con el código 9 y el subcódigo 2207042.
GET /<IG_ID>/content_publishing_limit devuelve quota_usage, el número de publicaciones realizadas por la cuenta en las últimas 24 horas. La referencia de ese endpoint aún indica quota_total como 50, y lo mismo hace la sección de carruseles de la guía de publicación, así que lee la cuota que devuelve el endpoint para la cuenta en lugar de confiar en cualquiera de las dos cifras publicadas.
¿Cómo funcionan los contenedores de medios?
Un contenedor es el medio que Instagram ha obtenido y preparado, a la espera de ser publicado. Una cuenta puede crear 400 en 24 horas móviles, más de los que puede publicar, lo que deja margen para volver a empezar tras un fallo. Un contenedor que no se publica en 24 horas caduca, y la única solución es crear uno nuevo.
Los contenedores de video necesitan procesarse primero. Su status_code indica IN_PROGRESS hasta que cambia a FINISHED, y Meta sugiere comprobarlo una vez por minuto durante no más de 5 minutos.
¿Dónde tiene que estar el medio?
En un servidor público. Meta descarga el archivo directamente desde la URL de la petición, en el momento del intento de publicación, así que el enlace tiene que funcionar en ese momento, sin inicio de sesión delante. Meta también recomienda URL formadas solo con caracteres US-ASCII, o la petición puede fallar.
Un archivo que Meta no puede obtener falla con el código 9004, subcódigo 2207052, y uno que tarda demasiado en descargarse falla con el subcódigo 2207003. Meta documenta su subida reanudable, que puede enviar un archivo de video desde una computadora, solo para configuraciones basadas en Facebook Login for Business, incluido Unified Login; con Instagram Login, los medios siempre provienen de una URL.
¿Cuáles son las reglas de imagen?
Solo JPEG. Se rechazan los formatos JPEG ampliados, como MPO y JPS, y también PNG.
- Tamaño de archivo: hasta 8 MB.
- Relación de aspecto: entre 4:5 y 1.91:1 para una foto; Meta recomienda 9:16 para una Historia.
- Ancho: de 320 a 1440 píxeles; las imágenes fuera de ese rango se escalan para ajustarse.
- Espacio de color: sRGB; las imágenes en otros espacios de color se convierten.
¿Cuáles son las reglas de los pies de foto?
Un pie de foto puede tener hasta 2,200 caracteres y 20 etiquetas @, con hasta 5 hashtags según la regla actual de Instagram (la referencia de la API de Meta aún indica 30), y una cuenta mencionada en él recibe una notificación cuando se publica la publicación. Los pies de foto corresponden a fotos, Reels y al contenedor del carrusel; los elementos del carrusel no llevan ninguno, y la referencia de Meta no describe ninguno para las Historias. Un pie de foto que supera el límite de longitud falla con el código 36004, subcódigo 2207010, y uno con demasiadas etiquetas @ con el subcódigo 2207040.
¿Qué deja fuera la publicación a través de la API?
Algunas funciones de la app de Instagram no tienen equivalente de publicación en la API.
- Etiquetas de compras y filtros.
- Stickers de Historias, como enlaces, encuestas y ubicaciones; mencionar una cuenta sin sticker sí funciona.
- Reels como elementos de un carrusel.
- Pies de foto en elementos individuales del carrusel.
Errores comunes
- Subir imágenes PNG o HEIC. La API solo publica JPEG, y los formatos JPEG ampliados como MPO y JPS también fallan.
- Publicar un contenedor de video de inmediato. Espera a que status_code indique FINISHED, o la llamada falla con el subcódigo 2207027.
- Alojar medios detrás de un inicio de sesión o en un enlace que caduca. Meta descarga el archivo durante el intento de publicación y necesita entonces una URL pública y simple.
- Revisar solo la longitud del pie de foto. Meta también limita las etiquetas @ a 20, y desde noviembre de 2026 el Centro de ayuda de Instagram permite 5 hashtags por publicación.
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿La API de Instagram puede publicar imágenes PNG?
No. Solo publica imágenes JPEG, así que convierte PNG u otro formato a JPEG antes de publicar.
¿Un carrusel cuenta como una publicación?
Sí. Frente al límite de 100 publicaciones por API, un carrusel cuenta una vez, sin importar cuántas fotos y videos contenga.
¿Cómo consulto cuántas publicaciones le quedan hoy a una cuenta?
Llama a GET /<IG_ID>/content_publishing_limit. Su campo quota_usage indica cuántas publicaciones realizó la cuenta por API en las últimas 24 horas.
¿El límite de la API de Instagram es de 50 o de 100 publicaciones al día?
100, según la guía de publicación de Meta, en 24 horas móviles. La referencia de content_publishing_limit aún indica un quota_total de 50, así que lee la cuota que devuelve ese endpoint para la cuenta en lugar de confiar en ninguna de las dos cifras.
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