Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Fallos de publicación en TikTok: spam_risk_too_many_posts, picture_size_check_failed y otros motivos de fallo

TikTok indica la causa de una publicación fallida en reason, en el endpoint de estado de API for Business, o en fail_reason de la Content Posting API. Los fallos de comprobación, como picture_size_check_failed, significan que el archivo incumple una regla de formato y hay que cambiarlo; video_pull_failed significa que TikTok no pudo descargarlo en una hora; spam_risk_too_many_posts significa demasiadas publicaciones por API en 24 horas. Un fallo marcado como internal puede simplemente reintentarse.

easyCoexistence sigue cada publicación de TikTok que publica hasta que TikTok la completa o la falla, para Claude, ChatGPT o tu propia plataforma: un fallo llega con el motivo de TikTok por correo, en la pantalla de Publicaciones y como evento post.failed, listo para reintentar.

reason

El campo /business/publish/status/ solo aparece cuando el estado es FAILED, con valores como frame_rate_check_failed.

fail_reason

El nombre que la Content Posting API da al mismo campo, en las respuestas de /v2/post/publish/status/fetch/.

1 hour

Tiempo de espera de descarga tras el cual TikTok falla una publicación con video_pull_failed o photo_pull_failed.

24 hours

Ventana tras la que se activa spam_risk_too_many_posts; TikTok sugiere publicar esa publicación desde su app móvil.

3 hours

Lo más habitual es que easyCoexistence envíe un correo al propietario por publicaciones fallidas en un canal; la publicación queda en Requiere atención.

¿Dónde informa TikTok del motivo por el que una publicación falló?

Tras la llamada de publicación, que solo inicia la tarea: su código 0 significa que TikTok la aceptó, no que la publicación vaya a publicarse. GET /business/publish/status/ devuelve FAILED con reason, y una app suscrita a los webhooks de publicación recibe post.publish.failed con ese mismo reason y el publish_id. El /v2/post/publish/status/fetch/ de la Content Posting API devuelve el campo como fail_reason:

A failed post in /business/publish/status/, from TikTok's example
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "reason": "frame_rate_check_failed",
    "status": "FAILED"
  }
}

¿Qué significa cada motivo de fallo y cómo se corrige?

Los motivos de TikTok, según describe su referencia de eventos de publicación, junto a la corrección que señala cada uno. Los cuatro primeros son comprobaciones que TikTok hace al archivo tras descargarlo, todas marcadas como no reintentables. La tabla de fallos de TikTok todavía indica 60 segundos como el video más largo para duration_check_failed, mientras que el endpoint de video documenta 600, o el max_video_post_duration_sec de la cuenta:

What TikTok foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing again if the post is still wanted

¿Qué fallos se pueden reintentar?

Los que se deben a la descarga o a TikTok mismo. Los demás necesitan otro archivo o una descripción distinta, una pausa, o no hacer nada:

  • Reintentar tal cual: internal, y video_pull_failed o photo_pull_failed una vez que la URL sea pública y lo bastante rápida.
  • Reintentar con un archivo nuevo: file_format_check_failed, duration_check_failed, frame_rate_check_failed y picture_size_check_failed.
  • Reintentar con una descripción nueva: spam_risk_text.
  • Esperar, o publicar desde la app de TikTok: spam_risk_too_many_posts.
  • No reintentar: auth_removed y spam_risk, como aconseja TikTok, o spam_risk_user_banned_from_posting.

¿En qué se diferencian los fallos de la Content Posting API?

Los mismos motivos, con otro campo y otro endpoint, y rechazos que llegan antes de que empiece el procesamiento. /v2/post/publish/status/fetch/ devuelve fail_reason, permite 30 peticiones por minuto y por token de usuario, y añade consejos de no reintentar para spam_risk_user_banned_from_posting y spam_risk_text. Varios rechazos llegan en cambio en la llamada init, con HTTP 403:

  • spam_risk_too_many_posts: el creador alcanzó el límite diario de publicaciones de la API.
  • unaudited_client_can_only_post_to_private_accounts: una app no auditada intentó publicar en una cuenta pública.
  • url_ownership_unverified: PULL_FROM_URL desde un dominio o prefijo que la app no ha verificado.
  • privacy_level_option_mismatch: un privacy_level que falta o está fuera de las opciones del creador.
  • reached_active_user_cap: la app alcanzó su cuota diaria de usuarios activos de publicación.

¿Qué falla antes de que TikTok vea la publicación?

Lo que easyCoexistence puede detectar primero, con un mensaje propio en lugar de un motivo de TikTok. El contenido multimedia de una publicación programada se copia al programarla, y un enlace que devuelve una página web, un error 404, un tipo de archivo incorrecto, o un archivo de más de 30 MB para una imagen o de 1 GB para un video, se rechaza en ese momento. Los enlaces de foto que terminan en .png, .gif, .bmp, .heic, .avif o .svg se rechazan antes de enviar nada, un canal que necesita volver a conectarse al publicar falla como reconnect, y al eliminar un canal se cancelan sus publicaciones programadas.

¿Cómo informa easyCoexistence de una publicación fallida en TikTok?

A través de su cola de publicación, que sigue cada publicación en TikTok tras la llamada de publicación, consultando /business/publish/status/ cada 20 segundos hasta PUBLISH_COMPLETE. Un estado FAILED hace fallar la publicación, cuyo error indica entre paréntesis el motivo de TikTok, como frame_rate_check_failed, y cada fallo lleva un failure_kind:

  • refused: TikTok respondió que no, como con un estado FAILED y su motivo.
  • uncertain: la llamada de publicación no obtuvo una respuesta clara, o TikTok no confirmó en 2 horas, así que la publicación puede estar en línea (may_be_published).
  • reconnect: TikTok rechazó el token de la cuenta, que necesita un nuevo inicio de sesión.
  • internal: easyCoexistence falló antes de entregar la publicación, así que no salió nada.

¿Cómo encuentras y reintentas una publicación fallida?

El propietario recibe un correo por cada fallo detectado en segundo plano, como máximo uno por canal cada 3 horas, y la URL de eventos de una plataforma recibe post.failed. La publicación aparece en Requiere atención en la pantalla de Publicaciones, con Reintentar, Reconectar y Descartar, y list_scheduled_posts la devuelve a Claude o ChatGPT. retry_scheduled_post la publica de nuevo, ahora, a partir de los archivos guardados 7 días tras el fallo; cuando may_be_published es true, consulta primero list_social_posts y pasa confirm solo si la publicación no aparece. Una publicación que necesita un archivo o una descripción nueva se vuelve a programar en su lugar.

Failed posts through MCP
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }

retry_scheduled_post { "post_id": "<POST_ID>" }

// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }

Errores comunes

  • Reintentar un fallo de comprobación con el mismo archivo. TikTok marca como no reintentables los fallos de formato, duración, frecuencia de fotogramas y tamaño de imagen.
  • Reintentar spam_risk_too_many_posts de inmediato. TikTok cuenta las publicaciones por API en 24 horas y sugiere publicar desde la app móvil.
  • Reintentar una publicación marcada como may_be_published sin mirar antes. TikTok pudo haberla publicado; revisa las últimas publicaciones de la cuenta, o se publicará dos veces.
  • Buscar fail_reason en la API for Business. Su endpoint de estado llama reason al campo; fail_reason pertenece a la Content Posting API.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué significa picture_size_check_failed en TikTok?

TikTok descargó la publicación y encontró que su imagen estaba por debajo del mínimo de 360 píxeles de alto y de ancho; hace falta un archivo más grande, ya que TikTok marca el fallo como no reintentable.

¿Qué es video_pull_failed?

TikTok no pudo descargar el video desde su URL, o no lo hizo dentro del límite de una hora. Comprueba que la URL sea pública y no tenga límite de ancho de banda, y después reintenta.

¿Cuánto dura spam_risk_too_many_posts?

TikTok cuenta las publicaciones hechas a través de la API en las últimas 24 horas, unas 15 al día por cuenta, y mientras tanto sugiere publicar desde la app móvil de TikTok.

¿Reintenta easyCoexistence por su cuenta una publicación fallida en TikTok?

No, después de que TikTok informe FAILED: la publicación espera en Requiere atención, se envía un correo al propietario, y Reintentar o retry_scheduled_post la envía de nuevo.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el