La API Instagram Basic Display ya no existe: qué usar en su lugar

Meta dejó obsoleta la API Instagram Basic Display el 4 de diciembre de 2024, y las peticiones ahora devuelven error. Lo que la reemplaza depende de la cuenta: la API de Instagram con Instagram Login para cuentas profesionales, el endpoint oEmbed para insertar publicaciones públicas, y para una cuenta personal normal, nada. Changelog consultado el 22 de octubre de 2026.

Qué le pasó de verdad a la API Basic Display

El changelog de la plataforma de Instagram lleva la entrada con fecha 4 de diciembre de 2024: «The Instagram Basic Display API has been deprecated.» Las peticiones devuelven un error en lugar de datos. No queda ningún periodo de gracia que planificar, ni ningún ajuste en el App Dashboard que la traiga de vuelta.

Basic Display era la fácil. Leía el perfil, los medios y los textos de un usuario con una cuenta personal de Instagram, sin Página de Facebook, sin convertir la cuenta a profesional, y con una revisión que la mayoría de los proyectos personales superaba. Por eso sigue estando en todas las respuestas de Stack Overflow, en paquetes de npm y en tutoriales fechados en 2023. Si tu integración se rompió y fuiste a buscar la solución, seguramente encontraste tres de esos antes de llegar aquí.

Otras dos fechas del mismo changelog cuentan mientras migras. Los valores de scope antiguos quedaron obsoletos el 27 de enero de 2025, sustituidos por la familia instagram_business_*. Y la función oEmbed Read está obsoleta desde el 3 de noviembre de 2025, con varios campos de respuesta de oEmbed eliminados.

Qué usar en su lugar, caso por caso

El patrón es el que Meta sigue en toda su plataforma desde 2023: hay API para las cuentas que son un negocio, y la API de lectura de cuentas personales se fue para siempre.

API de Instagram con Instagram Login: el reemplazo de verdad

Aquí es donde acaba casi todo el mundo. Cubre cuentas profesionales de Instagram, de empresa y de creador, y no exige una Página de Facebook vinculada, que es justo lo que la convierte en un sucesor real y no en un desvío. Las credenciales son de Instagram y el host es graph.instagram.com, mediante el flujo que Meta llama Business Login for Instagram.

Cuatro scopes cubren toda la superficie:

• instagram_business_basic, siempre obligatorio
• instagram_business_content_publish, para publicar medios
• instagram_business_manage_comments, para leer, responder, ocultar y borrar comentarios
• instagram_business_manage_messages, para los DM

La guía de migración de Meta lo describe como dos permisos por tarea: el scope básico más el scope concreto de mensajería, moderación de comentarios o publicación. Las capacidades que ofrece son moderación de comentarios, publicación de contenido, insights de medios, menciones y mensajería. Los límites documentados merecen una lectura antes de planificar: esta configuración no puede acceder a anuncios ni al etiquetado.

Así que la migración no es cambiar un host en una línea. Cambias el tipo de cuenta, el flujo de login, los nombres de los scopes y la revisión de permisos, y ganas un acceso de escritura que antes no tenías. Si lo que te preocupa son los tokens, escribí todo su ciclo de vida en los tokens de acceso de redes sociales.

API de Instagram con Facebook Login: la vía ligada a una Página

Si la cuenta ya está conectada a una Página de Facebook y tu app tiene credenciales de Página, esta es la variante que conviene mantener. Funciona con credenciales de Facebook contra la Graph API, y Meta la posiciona para integraciones existentes ligadas a una Página, no para proyectos nuevos. El conjunto de capacidades se solapa mucho con Instagram Login; la diferencia es por qué login pasa el usuario y si hace falta que exista una Página.

Elígela cuando una Página ya forma parte del producto, por ejemplo porque también publicas en Facebook. Elige Instagram Login cuando el usuario solo tiene Instagram y no quieres explicarle por qué tu app le pregunta por Facebook. Toda la superficie de ambas, con los endpoints y los límites de peticiones, está en la API Instagram Graph en 2026.

Insertar publicaciones públicas: oEmbed, con matices

Si lo único que hacías con Basic Display era poner una publicación en una página web, el endpoint que quieres es GET /instagram_oembed en graph.facebook.com. Devuelve el HTML de inserción para fotos, vídeos, Reels y publicaciones del feed, hasta 1.000 peticiones por hora.

Lo que no hará es más largo que lo que sí hace. No sirve cuentas privadas, inactivas ni con restricción de edad, ni cuentas que han desactivado las inserciones, ni Stories, ni nada dentro de un Shadow DOM. Y según la entrada de changelog del 8 de abril de 2025, la función oEmbed Read está obsoleta desde el 3 de noviembre de 2025, con campos de respuesta eliminados. Trátalo como una vía de mantenimiento, no como un cimiento.

API de Instagram para una cuenta personal: esta versión no existe

Esta es la respuesta honesta que nadie que escriba sobre Basic Display quiere dar. No existe ninguna API que lea los medios de una cuenta personal de Instagram. Basic Display era eso, y está apagada. Tus opciones son pedir al usuario que pase a una cuenta profesional, que es gratis y reversible en la app de Instagram, o retirar la función.

Lo que no debes hacer es recurrir a un scraper o a una librería no oficial que inicie sesión como el usuario. Es una infracción directa de los Platform Terms de Meta, y la cuenta que lo paga es la de tu usuario, no la tuya. Conté qué activa una marca y por qué en la automatización de Instagram en 2026.

Una lista de migración que cabe en una pantalla

1. Decide el tipo de cuenta que vas a soportar. La profesional lo desbloquea todo, la personal no desbloquea nada.
2. Registra el producto en tu app de Meta: API de Instagram con Instagram Login, o con Facebook Login si ya hay una Página en juego.
3. Sustituye los valores de scope antiguos por los nombres instagram_business_*. Los antiguos salieron el 27 de enero de 2025.
4. Reconstruye el login como Business Login for Instagram y guarda el token que recibes, no el que esperaba tu código antiguo.
5. Envía a App Review los scopes que de verdad usas. La publicación y la mensajería se revisan aparte de las lecturas básicas.
6. Revisa el changelog antes de desplegar. Tres de las fechas de este artículo fueron obsolescencias anunciadas meses antes del corte.

Si prefieres no cargar con nada de esto, ese es el trabajo que hace PlugKit: una API y un servidor MCP alojado para Instagram, Facebook, LinkedIn, TikTok, YouTube, X, WhatsApp y Telegram, con los flujos OAuth, el refresco de tokens y las rarezas de cada plataforma de nuestro lado. 49 $ al mes por 5 cuentas conectadas, cancelas cuando quieras. Solo habla con cuentas profesionales de Instagram, porque es lo único con lo que habla la API oficial. Para la parte de agentes, mira el servidor MCP de Instagram.

Preguntas frecuentes

¿Sigue disponible la API Instagram Basic Display?

No. El changelog de la plataforma de Instagram la registra como obsoleta el 4 de diciembre de 2024, y las peticiones devuelven error. No hay prórroga ni modo legacy.

¿Qué sustituyó a la Instagram Basic Display API?

La API de Instagram con Instagram Login, para cuentas profesionales de Instagram, de empresa y de creador, sin Página de Facebook necesaria. Cubre publicación, comentarios, mensajería, insights de medios y menciones, y a diferencia de Basic Display sabe escribir, no solo leer.

¿Puedo usar la API de Instagram con una cuenta personal?

No. Todas las API de Instagram actuales exigen una cuenta profesional, de empresa o de creador. Basic Display era la única vía para una cuenta personal y ya no está. Pasar a cuenta profesional en la app de Instagram no cuesta nada y se puede deshacer.

¿Sigo necesitando una Página de Facebook para usar la API de Instagram?

No con la API de Instagram con Instagram Login, que se autentica con credenciales de Instagram contra graph.instagram.com. Solo necesitas una Página para la API de Instagram con Facebook Login y para el soporte de Messenger API para Instagram.

¿Puedo seguir insertando publicaciones de Instagram sin una clave de API?

El endpoint oEmbed GET /instagram_oembed devuelve el HTML de inserción para fotos, vídeos, Reels y publicaciones del feed públicas, hasta 1.000 peticiones por hora. No funciona con cuentas privadas ni con Stories, y su función Read está obsoleta desde el 3 de noviembre de 2025, así que cuenta con que siga encogiendo.

AB

Antoine BlancoFundador de PlugKit. Gestiona sus propias cuentas de Instagram, YouTube y X a través de la API y del servidor MCP que se describen aquí.