X (Twitter) API Error ReferenceGuía completa de solución de problemas con soluciones

Referencia completa para errores de la API de X (Twitter). Encuentra soluciones para límites de uso, contenido duplicado, restricciones de longitud de video y errores de autenticación.

12 códigos de error
4 categorías
API v2

Categorías de Errores

Autenticación

2 errors

Limitación de tasa

2 errors

Contenido

5 errors

Video

3 errors

Todos los Códigos de Error

#Autenticación

unauthorizedrefresh-token

Las credenciales de X (Twitter) no son válidas. Vuelve a conectar tu cuenta.

Solución:

Tus credenciales de X/Twitter ya no son válidas. Esto puede suceder después de un cambio de contraseña o si revocaste el acceso de la app. Vuelve a conectar tu cuenta en la configuración.

invalid credentialsrefresh-token

Las credenciales de X (Twitter) no son válidas. Vuelve a conectar tu cuenta.

Solución:

Tus credenciales de autenticación son incorrectas o expiraron. Ve a la configuración de tu cuenta y vuelve a conectar tu cuenta de X/Twitter.

#Limitación de tasa

usage-cappedretry

Se alcanzó el límite de uso de X (Twitter). Inténtalo de nuevo más tarde.

Solución:

Has alcanzado los límites de uso de X para tu nivel de cuenta. Las cuentas gratuitas tienen límites más bajos. Espera a que tu cuota se restablezca o actualiza a X Premium para límites más altos.

usage capretry

Se alcanzó el límite de uso de X (Twitter). Inténtalo de nuevo más tarde.

Solución:

X aplica límites de uso basados en tu nivel de suscripción. El límite típicamente se restablece cada 24 horas. Considera actualizar a X Premium para límites más altos.

#Contenido

duplicateuser-error

Ya has publicado este contenido. Espera antes de publicar de nuevo o modifica tu contenido.

Solución:

X previene publicar contenido idéntico con demasiada frecuencia. Espera al menos 30 minutos antes de publicar el mismo contenido, o modifica tu publicación ligeramente para hacerla única.

you have already posted thisuser-error

Ya has publicado este contenido. Espera antes de publicar de nuevo o modifica tu contenido.

Solución:

Has publicado este contenido exacto recientemente. La detección de duplicados de X es muy sensible. Cambia tu texto, añade medios diferentes o espera antes de publicar.

duplicate-rulesretry

Ya has publicado esta publicación, espera antes de publicar de nuevo.

Solución:

Publicación duplicada detectada. Espera al menos 30-60 minutos antes de intentar publicar contenido similar. Esto ayuda a prevenir el spam en la plataforma.

invalid urluser-error

Tu publicación contiene una URL que no está permitida en X (Twitter).

Solución:

X bloquea ciertas URLs que violan sus políticas. Elimina la URL o usa un enlace diferente. Evita usar acortadores de enlaces que X haya puesto en lista negra.

The Tweet contains an invalid URLuser-error

Tu publicación contiene una URL que no está permitida en X (Twitter).

Solución:

La URL en tu publicación está en lista negra o considerada spam. Usa una URL diferente o elimina el enlace por completo. Asegúrate de que el dominio tenga buena reputación.

#Video

video longer than 2 minutesuser-error

Tu cuenta no puede publicar videos de más de 2 minutos. Actualiza a X Premium o acorta tu video.

Solución:

Las cuentas gratuitas de X están limitadas a videos de 2 minutos. Opciones: 1) Recorta tu video a menos de 2 minutos, o 2) Actualiza a X Premium/Premium+ para soporte de videos más largos.

video lengthuser-error

Tu cuenta no puede publicar videos de más de 2 minutos. Actualiza a X Premium o acorta tu video.

Solución:

Las restricciones de longitud de video se basan en tu nivel de suscripción. Gratis: 2min, Premium: 10min, Premium+: 120min. Actualiza o reduce la longitud de tu video.

This user is not allowed to post a video longer than 2 minutesuser-error

Tu cuenta no puede publicar videos de más de 2 minutos. Actualiza a X Premium o acorta tu video.

Solución:

Tu nivel de cuenta no admite videos de esta longitud. Actualiza a X Premium ($8/mes) para videos de 10 minutos o Premium+ para videos de 2 horas.

Mejores Prácticas

Manejo de Errores

  • Implementar detección de duplicados antes de publicar
  • Manejar límites de uso con lógica de reintento
  • Validar longitud de video según el nivel de cuenta
  • Monitorear reputación de URLs

Consejos de Prevención

  • Evitar publicar contenido duplicado dentro de 30 minutos
  • Verificar límites de longitud de video para tu nivel de cuenta
  • Usar solo URLs de buena reputación
  • Actualizar a X Premium para límites más altos

¿Necesitas Ayuda con X (Twitter) Integración?

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