Docs    Instagram    Solución de problemas

Referencia de mensajes de error de la API de Instagram

Última actualización por Michael Bodin-Lenoir11 de septiembre de 2026

Una tabla de referencia con los mensajes de error de la API de Instagram, su significado y cómo solucionarlos. También se tratan los retrasos en las solicitudes y el registro de errores.

Si recibes un mensaje de error cuando intentas mostrar tus entradas, puedes utilizar la siguiente tabla para diagnosticar el problema y encontrar la solución pertinente.

¿Por qué se retrasan las solicitudes de API?

Si tu sitio web intenta realizar varias solicitudes de API incorrectas en un breve periodo de tiempo, Instagram bloqueará temporalmente todas las solicitudes de tu sitio web. Para evitar esto, el plugin establecerá un retraso de 5 minutos hasta que se realice otra solicitud de API. Puedes guardar la configuración en Instagram Feed > Configuración > Feeds para intentar inmediatamente otra solicitud de API.

Veo mensajes de error que ya no se aplican. ¿A qué se debe?

El plugin registrará los errores de la API para ayudar a solucionar los problemas de conexión. Solo algunos de estos errores desaparecerán por sí solos cuando se resuelva el problema. Si deseas restablecer estos mensajes de error, ve a Instagram Feed > Ajustes > Avanzado y haz clic en el botón Restablecer situado junto a Restablecer registro de errores. También puedes guardar la configuración en Instagram Feed > Configuración > Feeds para borrar los errores relacionados con hashtags.

Error de base de datos: Permisos ALTER insuficientes para su usuario de base de datos.

Asegúrese de que el usuario de la base de datos tiene permisos ALTER. Póngase en contacto con su proveedor de alojamiento si es necesario. Una vez resuelto, desactive y vuelva a activar el plugin para completar la actualización.

Error 400 de la API: Tu cuenta está conectada a la cuenta de Facebook y la actividad futura de tu cuenta de Facebook está desactivada.

Debido a cómo funciona la API de Instagram/Facebook, si la configuración de actividad futura fuera de Facebook está desactivada, no podrás utilizar nuestras aplicaciones de Instagram o Facebook para mostrar la fuente. Para conectar la fuente y mostrar el feed, tendrás que conectarte utilizando una cuenta de Facebook o una cuenta de Instagram con su cuenta de Facebook conectada que sí lo tenga habilitado. Actualmente no hay manera de evitar esto, ya que es una limitación en la API directamente, que no podemos afectar.Puede encontrar información detallada sobre la actividad fuera de Facebook aquí: https://www.facebook.com/help/1224342157705160

Error: No se han encontrado entradas:

  • Feed de usuario: La cuenta no tiene publicaciones hechas en Instagram.com
  • Hashtag reciente: No se han realizado publicaciones en este hashtag en las últimas 24 horas
  • Estás usando muchas publicaciones de IGTV en tu feed - Ver a continuación
  • Problema con su código de acceso - Consulte el error 400 de la API: El código de acceso proporcionado no es válido.
  • Demasiado filtrado con includewords, excludewords, whitelist, o fotos de bloqueo - Ver este FAQ

Tu cuenta tiene muchas publicaciones en IGTV

Instagram aún no admite las publicaciones de IGTV en su API. Sin embargo, estas publicaciones se siguen contando en la solicitud de la API aunque no se devuelvan. Esto puede hacer que el plugin piense que no hay publicaciones disponibles si todas las publicaciones recientes son publicaciones de IGTV.

Solución:
Para solucionar este problema, ve a la pestaña "Personalizar" dentro de la página de configuración de "Instagram Feed" y busca el ajuste "Tamaño de solicitud de API" y auméntalo a 25 o más en función de la frecuencia con la que utilices las publicaciones de IGTV.

Su cuenta es privada: El token de acceso caducará.

Esto se debe a que la cuenta está configurada como "privada" en Instagram. Las cuentas privadas deben reconectarse manualmente cada 60 días para poder recuperar nuevas publicaciones.

Solución:
Haz tu cuenta "pública" o recuerda reconectar la cuenta una vez cada 60 días.

Error: No se pueden recuperar publicaciones para este hashtag: El hashtag "XXXXXXXX" solicitado por el usuario no puede verse debido a la falta de permisos, no es válido o no existe.

  • No se han realizado publicaciones públicas con este hashtag. Cuando se publique una entrada con este hashtag, este error se resolverá.

Error de API 100: Se ha intentado acceder a un campo no existente (media_product_type) en un nodo de tipo (Media)

Asegúrese de que el plugin está actualizado en el panel de control de WordPress > Plugins > Plugins instalados.

También tendrá que volver a conectar su fuente. Para obtener instrucciones sobre cómo hacerlo, consulta esta documentación sobre reconexión.

Error de API 100: Solicitud de obtención no admitida.

Error de API 100: Solicitud de obtención no admitida. El objeto con ID 'xxxxxxxxxxxxx' no existe, no se puede cargar porque faltan permisos o no admite esta operación.

Esto también puede deberse a que el ID de fuente no coincide con la fuente autenticada para el token de acceso. Una posible causa serían los cambios de configuración en Instagram/Facebook. Posibles causas:

  • Cambiar los usuarios administradores de la página de Facebook relacionada
  • Cambiar la contraseña de la cuenta de Instagram o Facebook
  • Cambiar la configuración de privacidad de Instagram o Facebook
  • Cambiar la configuración relacionada con los permisos de la aplicación para Instagram o Facebook

Solución:
Puede volver a conectar la Fuente siguiendo estas FAQ.

Nota: Si el mensaje de error sigue apareciendo después de hacer esto, intenta borrar el registro de errores en la siguiente ubicación: Instagram Feed > Configuración > Avanzado > botón "Restablecer registro de errores".

Error de API 190: Error validando token de acceso.

Tiene un problema con su código de acceso. Esto puede deberse a un cambio de contraseña en la cuenta conectada u otros cambios de seguridad, o a que nuestra aplicación se haya eliminado de las integraciones empresariales de la cuenta. También es posible que hayas copiado tu token de acceso incorrectamente al intentar conectar una cuenta.

Solución:

Elimina la fuente del plugin navegando a Instagram Feed > Configuración > elimina la(s) fuente(s) conectada(s) haciendo clic en el icono rojo de la papelera y, a continuación, haz clic en el botón Guardar cambios. Después de eso, intenta obtener un nuevo token de acceso y conéctate manualmente. Para asegurarte de que creas un token de acceso válido, puedes seguir nuestra guía aquí.

Error de API 18: Se ha alcanzado el límite de 30 búsquedas únicas de hashtags por semana.

Instagram tiene un límite de 30 búsquedas únicas de hashtags semanales. Si tu sitio requiere más de 30 hashtags, tendrás que crear una segunda cuenta de empresa de Facebook/Instagram y conectarla yendo a Instagram Feed > Configuración y haciendo clic en Añadir fuente en la sección Gestionar fuentes.

Error API 1: Se ha producido un error desconocido.

Asegúrate de que estás actualizado a la última versión del plugin. Si este error sigue apareciendo, es posible que haya un problema con la API de Facebook/Instagram. Ponte en contacto con el servicio de asistencia.

Error de API 2: Se ha producido un error inesperado. Vuelva a intentar la solicitud más tarde.

Puede haber un problema temporal con la API de Instagram/Facebook. Intenta borrar la caché en Instagram Feed > Configuración > Fuentes y haz clic en Borrar todas las cachés. Si el feed sigue sin actualizarse después de unas horas, ponte en contacto con el servicio de asistencia.

Error 999: No se ha podido descifrar el código de acceso.

Todos los datos de Instagram, incluidos los tokens de acceso, están encriptados en tu base de datos. Si migras tu base de datos desde otro sitio, como un sitio de desarrollo o de ensayo, es posible que tengas que volver a conectar tu cuenta o cuentas para que los feeds se actualicen siguiendo estos pasos:

Elimina la fuente del plugin navegando a Instagram Feed > Configuración > elimina la(s) fuente(s) conectada(s) haciendo clic en el icono rojo de la papelera y, a continuación, haz clic en el botón Guardar cambios. A continuación, haz clic en Añadir fuente y vuelve a crear la conexión. También puedes intentar recuperar un token de acceso y crear manualmente una conexión con nuestra guía aquí.

Si vuelves a conectar tu cuenta pero se vuelve a desconectar continuamente y aparece el Error 999, sigue los pasos de esta guía para corregir el problema.

Error de conexión: http_request_failed - cURL error 7: Fallo al conectar con api.instagram.com puerto 443: Conexión denegada

Algunos hosts tienen restricciones o ajustes de seguridad para impedir las peticiones remotas a otros sitios web.

Solución:
Normalmente pueden arreglar esto o hacer una excepción para tu sitio. Intenta ponerte en contacto con tu proveedor de alojamiento con un mensaje como este:

Parece que nuestro plugin de Instagram está encontrando un error al intentar conectarse a la API de Instagram. Los desarrolladores nos han pedido que nos pongamos en contacto con vosotros y os digamos que estamos viendo el error http_request_failed - cURL error 7: Failed to connect to api.instagram.com port 443: Connection timed out when trying to make remote connections to api.instagram.com/.

Error de conexión: http_request_failed - cURL error 6: Could not resolve host: graph.facebook.com

Puede que tu servidor no esté conectado a Internet o que tu host esté bloqueando la conexión. Si utilizas un entorno de desarrollo local, asegúrate de que estás conectado a Internet.

Error de conexión: http_request_failed - cURL error 28: La resolución ha expirado después de 10000 milisegundos

Es posible que tu servidor tenga restricciones para conectarse a la API de Instagram.

Solución:
Si esto ocurre al intentar conectar una fuente, intenta volver a conectar después de 10 minutos más o menos. Si esto no resuelve el problema o es intermitente, intenta ponerte en contacto con tu host y menciona que estás viendo este error al intentar conectarte a la API de Instagram.

Una solución alternativa es intentar conectarse como perfil "Business" siguiendo estas instrucciones.

Error de API 200: Requiere permiso instagram_basic para gestionar el objeto, la aplicación puede tener el permiso pero para usar esta API la aplicación debe ser propiedad de una empresa verificada.

Esto ocurre cuando se elimina la conexión entre una página de Facebook y el perfil de empresa de Instagram conectado al plugin.

Solución:

Para conectar tu fuente como perfil de empresa de Instagram, debe haber un enlace a una página de Facebook. Asegúrate de que tu cuenta está configurada correctamente siguiendo esta guía: Perfiles de empresa de Instagram - Smash Balloon.

Vuelva a conectar su fuente en el plugin. Para ello, siga los pasos que se indican a continuación:

  • Ve a tu WordPress dashboard > Instagram Feed > Settings > eliminar la(s) fuente(s) conectada(s) haciendo clic en el icono rojo de la papelera (Ver captura de pantalla), a continuación, haga clic en el botón Guardar configuración.
  • Haz clic en el botón Añadir fuente, selecciona tu Tipo de cuenta y haz clic en el botón azul Iniciar sesión con Facebook, cuando te envíen a Facebook, tendrás que hacer clic en el botón Editar configuración para revisar la configuración de conexión y asegurarte de que TODAS las páginas, perfiles y permisos están seleccionados.
  • Una vez añadida la fuente, pulse el botón Guardar cambios.
  • Vaya a la configuración del feed > Fuentes y asegúrese de que la cuenta que ha vuelto a conectar al plugin está vinculada al feed que muestra (Ver captura de pantalla).

Si sigues teniendo problemas para mostrar tus entradas después de haber probado los problemas comunes anteriores, ponte en contacto con el servicio de asistencia para obtener ayuda.

¿Ya has arreglado tu feed? Aquí te explicamos cómo evitar tener que volver a generarlo cada vez que se estropea.

Smash Balloon Instagram Feed Pro restablece la conexión de las fuentes que se han interrumpido con solo un par de clics, en lugar de tener que eliminarlas y volver a configurarlas desde cero. Cuenta con una garantía de devolución del dinero de 14 días.

Soluciona esto de una vez por todas
soporte

¿No ha encontrado la respuesta en los documentos?

Contacto

Categorías