Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Guía de la API de Instagram 2026: de su app a su primera publicación

En 2026, la API de Instagram lleva una app a su primera publicación en seis pasos: una cuenta profesional, una configuración de inicio de sesión, una app de Meta, permisos con el nivel de acceso adecuado, un token de acceso y, luego, un contenedor de medios creado con POST /<IG_ID>/media y publicado con media_publish. Comentarios, DMs, webhooks, métricas y límites de Meta vienen después. Para las apps nuevas, Meta recomienda Unified Login.

easyCoexistence convierte los pasos 2 a 5 en un solo inicio de sesión con Instagram: su app de Meta gestiona el inicio de sesión, renueva el token antes de que caduque y verifica la cuenta cada 6 horas, mientras que Claude, ChatGPT o su propia plataforma publica, programa, responde comentarios y DMs y consulta métricas mediante la API oficial de Meta.

3 setups

Unified Login, recomendado para las nuevas integraciones, además de Instagram Login y Facebook Login, que se mantienen para las existentes.

New apps

Las apps de Meta recién creadas no pueden configurar la API de Instagram con Instagram Login, según indica la guía de migración de Meta.

60 days

Cuánto dura un token de acceso de usuario de Instagram de larga duración; se puede renovar cuando tiene 24 horas.

100 posts

Publicaciones por API que una cuenta puede hacer en un periodo móvil de 24 horas; un carrusel cuenta como una.

2 to 3 days

Cuánto suele tardar App Review según la cuenta de Meta; normalmente procesa un envío en menos de una semana.

¿Cuáles son los pasos desde una app nueva hasta una primera publicación?

Seis pasos llevan a la primera publicación, y cuatro más definen lo que hace la app después. La cuenta debe ser profesional, la app elige una de las tres configuraciones de inicio de sesión de Meta, el propietario de la cuenta concede permisos y el servidor de la app guarda un token. Publicar requiere entonces dos llamadas. Comentarios, DMs, webhooks, métricas y límites vienen después, y las últimas secciones indican la página que cubre cada paso en detalle.

1Professional accountBusiness or Creator, switched in the Instagram app
2Login setupUnified Login for new apps, Instagram Login for existing ones
3Meta app and permissionsStandard Access to test, Advanced Access through App Review
4Access tokenFrom the owner's sign-in, kept on the server
5First postPOST /<IG_ID>/media, then media_publish

Paso 1: ¿qué cuenta de Instagram funciona con la API?

Una cuenta profesional, empresarial o de creador. La Plataforma de Instagram de Meta atiende solo cuentas profesionales, y ambos tipos funcionan igual para publicar, comentar, enviar DMs y consultar métricas. Una cuenta personal se cambia en la app de Instagram, en Tipo de cuenta y herramientas, y una cuenta privada pasa a ser pública al hacerlo. Instagram Login y Unified Login no necesitan una Página vinculada, mientras que Facebook Login sí la requiere.

Paso 2: ¿qué configuración de inicio de sesión debe usar la app?

Meta documenta tres, y la elección fija el host, el token y los nombres de los permisos. Su descripción general recomienda Unified Login para las nuevas integraciones, su página de Unified Login indica que las nuevas funciones de la API de Instagram solo se publican allí, y su guía de migración dice que las apps recién creadas no pueden configurar Instagram Login. Las integraciones existentes de Instagram Login siguen funcionando, sin fecha de fin anunciada.

  • Unified Login: el cliente inicia sesión con Instagram o mediante Facebook Login, elige un Portafolio Comercial y la app recibe un token de Business Integration System User.
  • Instagram Login: el propietario inicia sesión con Instagram, las llamadas van a graph.instagram.com con un token de Usuario de Instagram y los permisos instagram_business_*.
  • Facebook Login: la cuenta debe estar vinculada a una Página que la persona pueda administrar, con los permisos instagram_* y los de Página.

Paso 3: ¿cómo se crea la app de Meta?

En el App Dashboard, por un camino que depende de la configuración. La guía de Unified Login de Meta parte de una app con el caso de uso Manage messaging & content on Instagram, que pertenece a un Portafolio Comercial. En API setup with Unified login, la app crea una configuración, cuyo config_id indica los permisos y recursos a solicitar, guarda una URL de redirección HTTPS y copia la URL de inicio de sesión. Una app de Instagram Login existente conserva API setup with Instagram login, donde viven su ID y su secreto de app de Instagram.

Paso 4: ¿qué permisos y nivel de acceso necesita la app?

Un permiso por función, concedido por el propietario de la cuenta al iniciar sesión. Unified Login usa la familia instagram_*, como instagram_content_publish e instagram_manage_comments, e Instagram Login los nombres instagram_business_*. El Acceso estándar, el predeterminado, cubre las cuentas que usted posee o administra y a las personas con un rol en la app. Atender cuentas de otras empresas requiere Acceso avanzado, concedido permiso por permiso mediante App Review, con Business Verification.

Paso 5: ¿cómo obtiene la app un token de acceso?

A partir del inicio de sesión del propietario, intercambiado en el servidor y nunca en un navegador ni en una app móvil. Con Instagram Login, la redirección trae un código válido por una hora y de un solo uso; se convierte en un token de corta duración y luego en uno de larga duración, que dura 60 días y puede renovarse una vez que tenga un día de antigüedad. Con Unified Login, el código se convierte en un token de Business Integration System User, cuya caducidad depende de la configuración.

Paso 6: ¿cómo se publica una primera publicación?

Con dos llamadas. POST /<IG_ID>/media con una image_url pública, que Meta obtiene por sí misma, crea un contenedor; POST /<IG_ID>/media_publish con el ID de ese contenedor como creation_id lo publica y devuelve el ID del medio. Las imágenes deben estar en formato JPEG. Para un Reel u otro video, consulte el status_code del contenedor hasta que diga FINISHED, ya que publicar antes falla.

A first photo post with Instagram Login
POST https://graph.instagram.com/v26.0/<IG_ID>/media
  ?image_url=https://www.example.com/images/first-post.jpg
  &caption=Hello%20from%20the%20API
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_CONTAINER_ID>" }

POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
  ?creation_id=<IG_CONTAINER_ID>
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_MEDIA_ID>" }

Paso 7: ¿cómo funcionan los comentarios y los DMs?

Ambos empiezan con otra persona. GET /<IG_MEDIA_ID>/comments devuelve hasta 50 comentarios de primer nivel por petición, POST /<IG_COMMENT_ID>/replies responde a uno en público, y una respuesta privada envía al comentarista un único DM dentro de los 7 días posteriores al comentario. Los DMs llegan a las personas que escribieron primero, dentro de una ventana estándar de 24 horas para la mayoría de las acciones, una vez que el propietario activa Permitir acceso a los mensajes en la app de Instagram.

Paso 8: ¿cómo informan los webhooks a la app de lo que pasó?

Meta envía por POST un JSON a un endpoint HTTPS, que se verifica una sola vez devolviendo hub.challenge, y firma cada evento en X-Hub-Signature-256 con un HMAC-SHA256 de la carga útil, usando como clave el secreto de la app. La app selecciona campos como comments y messages en el App Dashboard, y luego suscribe cada cuenta mediante su edge subscribed_apps. Las notificaciones solo llegan a las apps en modo Live, y las notificaciones de comentarios requieren Acceso avanzado.

Paso 9: ¿cómo lee la app las métricas?

Desde dos edges: GET /<IG_ID>/insights para la cuenta y GET /<IG_MEDIA_ID>/insights para una publicación, un Reel o una historia. Las métricas de la cuenta, como reach, views y accounts_engaged, usan period=day con metric_type=total_value. views reemplazó a impressions en 2025, algunas métricas requieren al menos 100 seguidores, y Meta indica que los datos pueden retrasarse hasta 48 horas.

Paso 10: ¿qué límites condicionan la app?

Meta fija sus límites principales por cuenta, así que una cuenta nueva tiene su propia cuota en lugar de compartir una:

  • Llamadas: 4,800 veces las impresiones de la cuenta en un periodo móvil de 24 horas, por app y cuenta, sin contar la mensajería.
  • Publicación: 100 publicaciones hechas por API y 400 contenedores de medios por cuenta en 24 horas.
  • Mensajería: 100 llamadas a la Send API por segundo para texto, y 750 respuestas privadas por hora en publicaciones y Reels.
  • Contenedores: uno sin publicar durante 24 horas caduca y hay que crearlo de nuevo.

¿Qué página cubre cada paso en detalle?

Cada paso tiene su propia página de referencia en esta documentación, con los campos, errores y casos límite que esta guía omite. Las rutas siguientes cuelgan de la dirección del sitio, y la página de código muestra, una junto a otra en Python y Node.js, las llamadas de publicación, comentarios, métricas y webhooks:

Account type/docs/instagram/business-or-creator-account
Login setups/docs/instagram/unified-login
Meta app and access/docs/instagram/api-access, /docs/instagram/app-review
Permissions/docs/instagram/api-permissions
Tokens/docs/instagram/access-tokens
Code/docs/instagram/api-python-node
Publishing/docs/instagram/publishing-limits
Webhooks/docs/instagram/webhook-events
Insights/docs/instagram/insights-metrics
Limits/docs/instagram/api-rate-limits
When it stops working/docs/instagram/connection-lost

¿Cuál es el camino a través de easyCoexistence?

Un solo inicio de sesión en lugar de los pasos 2 a 5 y de la configuración de webhooks. En el panel, elija Nueva conexión, luego Instagram, inicie sesión con la cuenta empresarial o de creador y apruebe sus cinco permisos instagram_business_*; la app de Meta de easyCoexistence gestiona el inicio de sesión, renueva el token y verifica la cuenta cada 6 horas. Claude, ChatGPT o su propio agente trabajan entonces a través de https://easycoexistence.com/api/mcp, su código puede tomar el ID de la cuenta y la base de la API de get_social_credentials, y las publicaciones pueden programarse hasta 90 días antes desde la cola de easyCoexistence.

Errores comunes

  • Empezar una app nueva con Instagram Login. La guía de migración de Meta indica que las apps recién creadas no pueden configurarlo, y su descripción general recomienda Unified Login para las nuevas integraciones.
  • Llamar a una integración de Unified Login con un token de Usuario de Instagram. La guía de webhooks de Meta indica que esos tokens y graph.instagram.com no funcionan con Unified Login.
  • Publicar un contenedor de video de inmediato. media_publish falla con el subcódigo 2207027 hasta que el status_code del contenedor diga FINISHED.
  • Hacer sondeo de comentarios y DMs. Meta recomienda webhooks, que reducen las llamadas que hace la app y su riesgo de recibir un límite de tasa.
Hacerlo con EasyCoexistence

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

Preguntas frecuentes

¿Cuánto tarda obtener acceso a la API de Instagram?

Para cuentas que usted posee o administra, no hay espera: el Acceso estándar funciona desde el inicio. Atender a empresas de terceros requiere App Review, que según Meta suele tardar menos de una semana, y Business Verification.

¿Una app nueva de Meta todavía puede usar Instagram Login?

No según la guía de migración de Meta, que indica que las apps recién creadas no pueden configurarlo. Las integraciones existentes de Instagram Login siguen funcionando, y Meta no ha anunciado fecha de fin.

¿La API puede publicar un archivo de mi computadora?

No con Instagram Login, donde Meta obtiene cada imagen o video desde una URL pública. Meta documenta cargas reanudables, que aceptan un archivo de video local, para configuraciones basadas en Facebook Login for Business, incluido Unified Login.

¿Cuánto cuesta easyCoexistence por una cuenta de Instagram?

Cada cuenta de Instagram es una conexión: 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.

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