Blog
API de Instagram: qué es, para qué sirve y si es gratis
La API de Instagram (Meta la llama Instagram Platform) es un conjunto de APIs con el que una app publica contenido, modera comentarios, envía y recibe mensajes y lee estadísticas de cuentas profesionales de Instagram, de empresa o de creador. Con una cuenta personal no sirve: la documentación pide que cada usuario de la app tenga una cuenta profesional. En las páginas de la documentación que leímos, Meta no menciona un cobro por llamada. Lo que sí pone son condiciones: permisos, revisión de la app para atender cuentas ajenas y límites de uso.
Todo lo que sigue sale de la documentación de Instagram Platform, que Meta publica en inglés. Leímos cada fuente de esta página el 20 de noviembre de 2026.
Un ejemplo: una agencia que quiere su propio panel
Caso ficticio. Agencia Faro lleva las redes de ocho clientes y quiere que su sistema interno publique tres reels al día por cliente y traiga los comentarios para responderlos desde ahí. Con la documentación en la mano, esto es lo que le toca:
- Cuentas. Las ocho tienen que ser cuentas profesionales de Instagram. Si un cliente tiene una cuenta personal, primero la cambia.
- Acceso. Si la app solo atiende cuentas que la agencia administra, Meta dice que el acceso estándar (Standard Access) «es todo lo que tu app necesita» (traducción nuestra). Si mañana la agencia quiere vender ese panel a otras agencias, con cuentas que no administra, necesita el acceso avanzado (Advanced Access), que exige la revisión de la app (App Review) y la verificación del negocio.
- Límite de publicación. Tres reels al día por cliente quedan muy lejos del tope de 100 publicaciones por API cada 24 horas por cuenta.
- Trabajo técnico. Alguien tiene que programar el inicio de sesión, guardar los permisos de cada cuenta y alojar los videos en un servidor público, porque la API los toma desde una URL.
¿La API de Instagram es gratis?
En lo que leímos, Meta no publica una tarifa. Ni la página general, ni la de publicación de contenido, ni la de límites de frecuencia, ni las de niveles de acceso y revisión de la app mencionan un precio, un plan de pago o un cobro por llamada.
Por eso no te decimos «gratis para siempre»: la documentación no menciona un cobro por llamada, pero tampoco hay una página de Meta que prometa que nunca lo habrá. Lo que tiene un costo real es lo que pones tú: el desarrollo, el mantenimiento cuando Meta cambia algo y el servidor donde alojas lo que publicas.
Para la API de WhatsApp, Meta sí publica que cobra por mensaje. Lo explicamos en cuánto cuesta la API de WhatsApp. No traslades esas tarifas a Instagram: son productos distintos.
Qué cuenta y qué configuración necesitas
La documentación dice que «tus usuarios de la app deben tener una cuenta profesional de Instagram», y que esa cuenta «puede representar a una empresa o a un creador» (traducción nuestra). Después ofrece tres maneras de conectar esa cuenta:
| Configuración | Cómo entra el usuario | ¿Pide una página de Facebook? | Qué dice Meta |
|---|---|---|---|
| Instagram API with Unified Login | Con Instagram o con Facebook | No | Es la recomendada para integraciones nuevas, y las funciones nuevas de la API salen solo para esta configuración |
| API de Instagram con inicio de sesión de Instagram | Con Instagram | No | No puede acceder a anuncios ni a etiquetado |
| API de Instagram con inicio de sesión de Facebook | Con Facebook | Sí, la cuenta tiene que estar vinculada a una página | Los mensajes pasan por la plataforma de Messenger |
Las dos últimas son las que Meta nombra en español en su anuncio sobre la API de visualización básica. La primera no tiene nombre en español en lo que leímos; su página es la de Unified Login.
Qué puedes hacer con la API de Instagram
La tabla de funciones de la documentación general marca esto:
- En las tres configuraciones: moderar comentarios, publicar contenido, leer estadísticas (insights) y ver las menciones de tu cuenta.
- Mensajes: con Unified Login y con inicio de sesión de Instagram, directo; con inicio de sesión de Facebook, a través de la plataforma de Messenger.
- Solo con Unified Login o inicio de sesión de Facebook: búsqueda por hashtag, etiquetado de productos y anuncios de colaboración (partnership ads).
Para publicar, la documentación de publicación cubre imágenes sueltas, videos, reels, carruseles de imágenes y videos, e historias. Pone tres restricciones que conviene saber antes de diseñar: JPEG es el único formato de imagen admitido, y no se admiten etiquetas de compras ni filtros.
Los límites que vas a encontrar
Publicaciones. «Las cuentas de Instagram tienen un límite de 100 publicaciones hechas por API en un período móvil de 24 horas» (traducción nuestra), y un carrusel cuenta como una. Ojo: en el apartado de carruseles, la misma página dice 50 publicaciones en 24 horas. Como las dos cifras conviven, diseña pensando en la más baja y consulta el uso real de cada cuenta con el endpoint content_publishing_limit, que la documentación indica para eso.
Llamadas. Fuera de los mensajes, las llamadas se cuentan por cada par de app y usuario, en una ventana móvil de 24 horas, con esta fórmula de la página de límites de frecuencia: llamadas en 24 horas = 4800 × número de impresiones, donde las impresiones son las veces que el contenido de esa cuenta apareció en una pantalla en las últimas 24 horas. Si pasas el límite, las llamadas fallan con el error 80002 hasta que el conteo baja. La búsqueda por hashtag y Business Discovery siguen otros límites, los de la plataforma.
Mensajes. Tienen límites propios por cuenta profesional; por ejemplo, 750 llamadas por hora a la API de respuestas privadas para comentarios de publicaciones y reels, según la página general. Qué mensajes automáticos permite Meta, en qué ventana y con qué reglas está en cuántos mensajes automáticos permite enviar Instagram.
Acceso y revisión. Según la página de niveles de acceso, con acceso estándar los permisos solo se pueden pedir a personas que tienen un rol en tu app. Para cualquier otro usuario hace falta el acceso avanzado, y para eso, la verificación del negocio; puede haber además revisión por permiso. Si tu app la usarán personas sin un rol en ella, la revisión de la app es obligatoria, y Meta rechaza la solicitud completa si no puede entrar a tu app para probarla.
Qué no permite
- Cuentas personales. La documentación exige cuentas profesionales. Y la antigua API para apps de consumidores se cerró: «A partir del 4 de diciembre de 2024, la API de visualización básica de Instagram dejará de estar disponible», y desde esa fecha «ya no habrá un conjunto de API de Instagram para apps de desarrolladores para consumidores», según el anuncio de Meta.
- Anuncios y etiquetado con inicio de sesión de Instagram. Esa configuración, según su página, «no puede acceder a anuncios ni a etiquetado» (traducción nuestra).
- Imágenes que no sean JPEG, etiquetas de compras y filtros al publicar, como vimos arriba.
Si te preocupa que una herramienta conectada por API te marque la cuenta, la diferencia entre una app autorizada y una que pide tu contraseña está en qué significa que Instagram sospeche de comportamiento automatizado.
API directa o una herramienta: cómo decidir
- Construyes un producto para cuentas que no son tuyas (un programador de publicaciones, un CRM, una plataforma para creadores): necesitas la API directa, con acceso avanzado, revisión de la app y verificación del negocio. Empieza por Unified Login, que es la que Meta recomienda para integraciones nuevas.
- Conectas tus cuentas, o las que administras, a un sistema propio y tienes quien programe: la API con acceso estándar alcanza, según Meta. Calcula el mantenimiento, no solo la primera versión.
- No vas a programar y quieres que el trabajo se haga. Una herramienta de gestión de redes te ahorra el inicio de sesión, los permisos y los límites. Si además quieres que tu asistente de IA trabaje en tus cuentas, la comparación entre los dos caminos está en API o MCP para redes sociales: cuál necesitas.
HeyMark no tiene una API REST pública por ahora: el acceso programático es por MCP, gratis en todos los planes (las acciones conservan sus límites y costos de IA en créditos). Con él, Claude, ChatGPT (en ChatGPT, crear o publicar requiere el modo desarrollador activo) u otro cliente compatible publica, responde comentarios y mensajes directos, modera, automatiza y comparte reportes y calendarios con tu propia cuenta. Cómo se conecta y qué herramientas trae está en la página del servidor MCP de HeyMark.
Planifica el próximo post en HeyMark.
Guarda la idea, revisa el texto con tu equipo y mira cómo le fue después en las cuentas que conectaste.