Instagram API Error ReferenceGuía completa de solución de problemas con soluciones

Referencia completa para errores de la API Instagram Graph. Encuentra soluciones para cargas de medios, problemas de cuenta empresarial, carruseles y etiquetado de productos.

32códigos de error
8categorías
Graph API v19.0

Categorías de Errores

Autenticación

5 errors

Carga de medios

8 errors

Formato de medios

8 errors

Contenido

3 errors

Carrusel

1 error

Etiquetado de productos

4 errors

Limitación de tasa

2 errors

Servidor

1 error

Todos los Códigos de Error

#Autenticación

REVOKED_ACCESS_TOKENrefresh-token

El token de acceso de Instagram ha sido revocado. Vuelve a conectar tu cuenta de Instagram.

Solución:

Tu token de acceso de Instagram fue revocado. Esto sucede cuando eliminas los permisos de la app en la configuración de Instagram. Ve a la configuración de tu cuenta y vuelve a conectar Instagram con todos los permisos requeridos.

session has been invalidatedrefresh-token

Tu sesión de Instagram ha expirado. Vuelve a conectar tu cuenta de Instagram.

Solución:

Tu sesión de Instagram ya no es válida. Esto puede suceder después de un cambio de contraseña o verificación de seguridad. Vuelve a conectar tu cuenta de Instagram para establecer una nueva sesión.

the user is not an instagram businessrefresh-token

Tu cuenta de Instagram debe ser una cuenta Business. Conviértela a una cuenta Business y vuelve a conectar.

Solución:

La API de Instagram requiere una cuenta Business o Creator. Convierte tu cuenta: Ve a Configuración de Instagram → Cuenta → Cambiar a cuenta profesional → Elegir Business.

2207050user-error

Tu cuenta de Instagram ha sido restringida. Verifica el estado de tu cuenta en Instagram.

Solución:

Instagram ha restringido tu cuenta. Inicia sesión directamente en Instagram para ver si hay advertencias o restricciones. Es posible que necesites verificar tu identidad o apelar la restricción.

Not enough permissions to postuser-error

No hay suficientes permisos para publicar.

Solución:

La app no tiene los permisos requeridos. Al reconectar, asegúrate de otorgar todos los permisos, especialmente 'instagram_content_publish' e 'instagram_basic'.

#Carga de medios

2207003user-error

Timeout downloading media, please try again.

Solución:

Instagram couldn't download your media from the URL within the timeout period. Ensure your media URL is publicly accessible and the server is responding quickly. Try re-uploading.

2207020user-error

Media expired, please upload again.

Solución:

The media container expired before publishing. Instagram media containers expire after 24 hours. Create a new media container and publish it immediately.

2207032user-error

Failed to create media, please try again.

Solución:

Instagram failed to create the media container. This could be a temporary issue. Wait a moment and try again. Ensure your media meets Instagram's specifications.

2207053user-error

Unknown upload error, please try again.

Solución:

An unknown error occurred during upload. Check that your media file is valid and meets Instagram's requirements. Try uploading a different file to isolate the issue.

2207052user-error

Media fetch failed, please try again.

Solución:

Instagram couldn't fetch your media from the provided URL. Verify the URL is publicly accessible, returns the correct content-type header, and the file is valid.

2207006user-error

Media not found, please upload again.

Solución:

The media container was not found. It may have been deleted or expired. Create a new media container and try again.

2207008user-error

Media builder expired, please try again.

Solución:

The media builder session expired. This happens if too much time passed between creating the container and publishing. Create and publish in one flow.

2207027user-error

Unknown error, please try again later or contact support.

Solución:

An unknown error occurred. Wait a few minutes and try again. If the issue persists, contact support with the full error details.

#Formato de medios

2207004user-error

Image is too large.

Solución:

Reduce your image file size. Instagram has a maximum file size of 8MB for images. Use an image compression tool to reduce the file size while maintaining quality.

2207005user-error

Unsupported image format.

Solución:

Instagram only supports JPG and PNG image formats. Convert your image to one of these formats before uploading.

2207009user-error

Aspect ratio not supported (must be between 4:5 and 1.91:1).

Solución:

Instagram requires aspect ratios between 4:5 (portrait) and 1.91:1 (landscape). Crop or resize your image to fit within these limits.

36003user-error

Aspect ratio not supported (must be between 4:5 and 1.91:1).

Solución:

Your image aspect ratio is outside Instagram's allowed range. Use 1:1 (square), 4:5 (portrait), or 1.91:1 (landscape). Avoid extreme aspect ratios.

36001user-error

Invalid Instagram image resolution max: 1920x1080px.

Solución:

Instagram limits image resolution to 1920x1080 pixels. Resize your image to fit within these dimensions.

2207026user-error

Unsupported video format.

Solución:

Instagram only supports MP4 video format with H.264 codec and AAC audio. Convert your video to meet these specifications.

2207057user-error

Invalid thumbnail offset for video.

Solución:

The thumbnail offset you specified is invalid. It must be within the video duration. Use a value between 0 and the video length in milliseconds.

2207023user-error

Unknown media type.

Solución:

Instagram couldn't determine your media type. Ensure you're specifying the correct media_type parameter (IMAGE, VIDEO, or CAROUSEL_ALBUM).

#Contenido

2207010user-error

Caption is too long.

Solución:

Instagram captions have a maximum length of 2,200 characters. Shorten your caption and try again.

2207001user-error

Instagram detected that your post is spam. Try changing the content.

Solución:

Instagram's spam detection flagged your content. Avoid repetitive posts, excessive hashtags, or spammy language. Wait a while and try posting different content.

2207051user-error

Instagram blocked your request.

Solución:

Instagram blocked this request, likely due to rate limiting or suspicious activity. Wait 15-30 minutes before trying again and reduce posting frequency.

#Etiquetado de productos

2207035user-error

Product tag positions not supported for videos.

Solución:

You cannot specify product tag positions for video posts. Only image posts support positioned product tags.

2207036user-error

Product tag positions required for photos.

Solución:

When tagging products in photos, you must specify x and y coordinates for tag positions. Provide position data for all product tags.

2207037user-error

Product tag validation failed.

Solución:

One or more product tags are invalid. Verify that all product IDs exist in your catalog and position coordinates are between 0.0 and 1.0.

2207040user-error

Too many product tags.

Solución:

Instagram limits the number of product tags per post. Reduce the number of products you're tagging (maximum is typically 5 products per image).

#Limitación de tasa

Page request limit reacheduser-error

Page posting for today is limited, please try again tomorrow.

Solución:

You've reached Instagram's daily posting limit. Instagram allows 25 posts per day. Wait until the next day to post more content.

2207042user-error

You have reached the maximum of 25 posts per day allowed for your account.

Solución:

Instagram enforces a 25 posts per day limit. Wait until tomorrow to post more content. Consider scheduling your posts to spread them across multiple days.

#Servidor

An unknown error occurredretry

Instagram encountered an unknown error, retrying...

Solución:

Instagram experienced a temporary error. The system will automatically retry. If it continues failing, wait a few minutes before trying again.

Mejores Prácticas

Manejo de Errores

  • Implementar reintentos automáticos para procesamiento de medios y errores de servicio
  • Manejar la expiración del contenedor de medios (límite de 24 horas)
  • Validar especificaciones de medios antes de cargar
  • Monitorear la salud y restricciones de la cuenta de Instagram

Consejos de Prevención

  • Asegurar cuenta Business o Creator antes de conectar
  • Validar formato, tamaño y relación de aspecto de medios
  • Crear y publicar contenedores de medios dentro de 24 horas
  • Respetar el límite de 25 publicaciones por día

¿Necesitas Ayuda con Instagram Integración?

Nuestra API maneja escenarios de error automáticamente con lógica de reintento inteligente y registro detallado.