Referencia de Errores de la API de TikTokGuía completa de solución de problemas con soluciones

Referencia completa para errores de la API de TikTok. Encuentra soluciones para detección de spam, errores de formato de video, permisos de alcance y límites de tasa.

25 códigos de error
•
7 categorías
•
API v1
← Volver a Integración TikTok View API Documentation

Categorías de Errores

Autenticación

3 errors

Spam

6 errors

Formato de video

6 errors

Medios

3 errors

Límite de tasa

2 errors

Estado de la app

3 errors

Server

2 errors

Todos los Códigos de Error

#Autenticación

access_token_invalidrefresh-token

El token de acceso de TikTok no es válido. Vuelve a conectar tu cuenta de TikTok.

Solución:

Tu token de acceso ya no es válido. Ve a la configuración de la cuenta y vuelve a conectar tu cuenta de TikTok para obtener un nuevo token válido.

scope_not_authorizedrefresh-token

Faltan permisos requeridos de TikTok. Vuelve a conectar con todos los alcances requeridos.

Solución:

No otorgaste todos los permisos requeridos. Al reconectar, asegúrate de aprobar todos los alcances solicitados incluyendo video.upload y user.info.basic.

scope_permission_missedrefresh-token

Se requieren permisos adicionales, vuelve a autenticarte.

Solución:

Se necesitan permisos adicionales para esta operación. Vuelve a conectar tu cuenta de TikTok y asegúrate de que todos los permisos estén otorgados.

#Spam

spam_risk_user_banned_from_postinguser-error

Cuenta baneada de publicar. Verifica el estado de tu cuenta de TikTok.

Solución:

Tu cuenta de TikTok ha sido restringida de publicar. Inicia sesión directamente en TikTok para ver si hay advertencias. Es posible que necesites apelar la restricción.

spam_risk_textuser-error

TikTok detectó posible spam en el texto de la publicación.

Solución:

Tu descripción o texto fue marcado como spam. Evita contenido repetitivo, enlaces excesivos o lenguaje promocional. Intenta publicar contenido diferente.

spam_risk_too_many_postsuser-error

Se alcanzó el límite de publicaciones diarias. Inténtalo de nuevo mañana.

Solución:

Has excedido el límite de publicaciones diarias de TikTok. Espera 24 horas antes de publicar de nuevo. Considera espaciar tus publicaciones en varios días.

spam_risk_too_many_pending_shareuser-error

The daily upload cap from the API is reached for the current user.

Solución:

To reduce spamming, TikTok limits the number of videos that can be uploaded via API that are not pending approval and posting by the creator. There may be at most 5 pending shares within any 24-hour period.

spam_riskuser-error

TikTok detectó posible spam.

Solución:

El sistema de detección de spam de TikTok marcó tu contenido. Asegúrate de que tu contenido sea original y siga las pautas de la comunidad de TikTok. Evita publicaciones repetitivas.

reached_active_user_capuser-error

Daily active user quota reached, please try again later.

Solución:

Your app has reached its daily active user limit. This is set by TikTok based on your app's status. Wait 24 hours or request a quota increase.

#Formato de video

file_format_check_faileduser-error

File format is invalid. Please check TikTok video specifications.

Solución:

Your video format is not supported. TikTok requires MP4 or WebM format. Convert your video and ensure it meets TikTok's specifications.

duration_check_faileduser-error

Video duration is invalid. Please check TikTok video specifications.

Solución:

Video duration must be between 3 seconds and 10 minutes. Trim your video to fit within these limits.

frame_rate_check_faileduser-error

Video frame rate is invalid. Please check TikTok video specifications.

Solución:

TikTok requires a frame rate between 23-60 fps. Re-encode your video with a supported frame rate.

picture_size_check_faileduser-error

Picture / Video size is invalid, must be at least 720p.

Solución:

Your video resolution is too low. TikTok requires minimum 720p resolution. Use a higher quality video source.

video durationuser-error

Video duration exceeds TikTok's limits. Please use a shorter video.

Solución:

Your video is too long. Maximum duration is 10 minutes. Edit your video to be shorter or split it into multiple parts.

file sizeuser-error

File size exceeds TikTok's limits. Please use a smaller file.

Solución:

Maximum file size is typically 287MB for videos. Compress your video or reduce its quality to meet the size limit.

#Medios

video_pull_faileduser-error

Failed to pull video from URL. Please check the video URL is accessible.

Solución:

TikTok couldn't download your video from the provided URL. Ensure the URL is publicly accessible, returns correct headers, and the file is valid.

photo_pull_faileduser-error

Failed to pull photo from URL. Please check the photo URL is accessible.

Solución:

TikTok couldn't download your image. Verify the URL is publicly accessible and returns the correct content-type header (image/jpeg or image/png).

invalid_file_uploaduser-error

Invalid file format or specifications not met.

Solución:

Your file doesn't meet TikTok's requirements. Check that it's a valid video/image file in a supported format and meets all specifications.

#Límite de tasa

rate_limit_exceededretry

TikTok rate limit exceeded. Please try again in a few moments.

Solución:

You've made too many requests too quickly. Wait a few minutes before trying again. The system will automatically retry for you.

too many requestsretry

TikTok rate limit exceeded. Please try again in a few moments.

Solución:

TikTok is rate limiting your requests. Reduce the frequency of API calls and implement exponential backoff in your retry logic.

#Estado de la app

unaudited_client_can_only_post_to_private_accountsuser-error

Your app is in development mode and can only post privately. Please submit for TikTok review for public posting.

Solución:

Your TikTok app is not approved for production. Submit your app for TikTok's review process to enable public posting capabilities.

url_ownership_unverifieduser-error

URL ownership not verified, please verify domain ownership.

Solución:

You need to verify ownership of any external URLs in your posts. Add the verification code to your domain or use the TikTok developer console to verify.

privacy_level_option_mismatchuser-error

Privacy level mismatch, please check privacy settings.

Solución:

The privacy level you specified doesn't match your app's capabilities or account settings. Review your app's permissions and the privacy settings.

#Server

internalretry

There is a problem with TikTok servers, please try again later.

Solución:

TikTok is experiencing server issues. This is temporary. Wait a few minutes and try again. The system will automatically retry.

invalid_paramsuser-error

Invalid request parameters, please check content format.

Solución:

One or more parameters in your request are invalid. Review the TikTok API documentation and ensure all required fields are present and correctly formatted.

Mejores Prácticas

Manejo de Errores

  • →Implementar estrategias de evitación de detección de spam
  • →Validar formato y especificaciones de video antes de cargar
  • →Manejar límites de tasa con retroceso exponencial
  • →Enviar app para aprobación de producción

Consejos de Prevención

  • →Usar formato MP4/WebM, mínimo 720p, 23-60 fps
  • →Mantener videos de 3 segundos a 10 minutos
  • →Evitar contenido repetitivo o promocional
  • →Verificar propiedad del dominio para URLs externas

¿Necesitas Ayuda con TikTok Integración?

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

Comenzar a ConstruirVer Documentación