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

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.

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.

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.

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.

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'.

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.

Solución:

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

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.

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.

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.

Solución:

The media container was not found. It may have been deleted or expired. Create a new media container and 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.

Solución:

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

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.

Solución:

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

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.

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.

Solución:

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

Solución:

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

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.

Solución:

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

Solución:

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

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.

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.

Solución:

Your carousel doesn't meet Instagram's requirements. Ensure all items are the same type (all images or all videos), have consistent aspect ratios, and you have 2-10 items.

Solución:

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

Solución:

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

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.

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).

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.

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.

Solución:

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