AccediInizia la prova gratuita
easyCoexistence API ufficiali

Pubblicazioni TikTok fallite: spam_risk_too_many_posts, picture_size_check_failed e altri motivi di errore

TikTok indica la causa di un post fallito in reason, nell'endpoint di stato dell'API for Business, o in fail_reason sulla Content Posting API. I controlli falliti come picture_size_check_failed significano che il file viola una regola di formato e va modificato; video_pull_failed significa che TikTok non è riuscito a scaricarlo entro un'ora; spam_risk_too_many_posts significa troppi post via API in 24 ore. Un errore marcato internal può semplicemente essere ritentato.

easyCoexistence segue ogni post TikTok che pubblica finché TikTok non lo completa o non lo fa fallire, per Claude, ChatGPT o la tua piattaforma: un errore arriva con il motivo di TikTok via e-mail, nella schermata Post e come evento post.failed, pronto per un nuovo tentativo.

reason

Il campo /business/publish/status/ compare solo quando lo stato è FAILED, con valori come frame_rate_check_failed.

fail_reason

Il nome che la Content Posting API dà allo stesso campo, nelle risposte di /v2/post/publish/status/fetch/.

1 hour

Timeout di download dopo il quale TikTok fallisce un post con video_pull_failed o photo_pull_failed.

24 hours

Finestra alla base di spam_risk_too_many_posts; TikTok suggerisce di pubblicare quel post dall'app mobile.

3 hours

Di norma easyCoexistence invia un'e-mail al titolare per i post falliti su un canale; il post resta in attesa sotto Richiede attenzione.

Dove TikTok segnala il motivo per cui un post è fallito?

Dopo la chiamata di pubblicazione, che avvia solo l'attività: il codice 0 significa che TikTok l'ha accettata, non che il post andrà online. GET /business/publish/status/ restituisce poi FAILED con reason, e un'app iscritta ai webhook di pubblicazione riceve post.publish.failed con lo stesso reason e il publish_id. L'endpoint /v2/post/publish/status/fetch/ della Content Posting API restituisce il campo come 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"
  }
}

Cosa significa ciascun motivo di errore e come si risolve?

I motivi di TikTok, secondo il suo riferimento sugli eventi di pubblicazione dei post, accanto alla soluzione a cui ciascuno rimanda. I primi quattro sono controlli che TikTok esegue sul file dopo averlo scaricato, tutti marcati come non ritentabili. La tabella degli errori di TikTok indica ancora 60 secondi come durata massima per duration_check_failed, mentre l'endpoint video ne documenta 600, oppure il max_video_post_duration_sec dell'account:

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

Quali errori possono essere ritentati?

Quelli causati dal download o da TikTok stesso. Gli altri richiedono un file o una didascalia diversi, una pausa, o nessuna azione:

  • Riprova così com'è: internal, e video_pull_failed o photo_pull_failed una volta che l'URL è pubblico e abbastanza veloce.
  • Riprova con un nuovo file: file_format_check_failed, duration_check_failed, frame_rate_check_failed e picture_size_check_failed.
  • Riprova con una nuova didascalia: spam_risk_text.
  • Attendi, oppure pubblica dall'app TikTok: spam_risk_too_many_posts.
  • Non riprovare: auth_removed e spam_risk, come consiglia TikTok, oppure spam_risk_user_banned_from_posting.

In cosa differiscono gli errori della Content Posting API?

Gli stessi motivi, con un campo ed endpoint diversi, e rifiuti che arrivano prima dell'avvio dell'elaborazione. /v2/post/publish/status/fetch/ restituisce fail_reason, consente 30 richieste al minuto per token utente, e aggiunge il consiglio di non riprovare per spam_risk_user_banned_from_posting e spam_risk_text. Alcuni rifiuti arrivano invece alla chiamata di init, con HTTP 403:

  • spam_risk_too_many_posts: il creator ha raggiunto il limite giornaliero di post dell'API.
  • unaudited_client_can_only_post_to_private_accounts: un'app non verificata ha tentato di pubblicare per un account pubblico.
  • url_ownership_unverified: PULL_FROM_URL da un dominio o prefisso che l'app non ha verificato.
  • privacy_level_option_mismatch: un privacy_level mancante o non compreso tra le opzioni del creator.
  • reached_active_user_cap: l'app ha raggiunto la sua quota giornaliera di utenti attivi per la pubblicazione.

Cosa fallisce prima che TikTok veda il post?

Ciò che easyCoexistence può intercettare per primo, con un messaggio proprio invece di un motivo di TikTok. Il contenuto multimediale di un post programmato viene copiato al momento della programmazione, e un link che restituisce una pagina web, un 404, il tipo sbagliato o un file oltre 30 MB per un'immagine o 1 GB per un video viene rifiutato in quel momento. I link di foto che terminano in .png, .gif, .bmp, .heic, .avif o .svg vengono rifiutati prima dell'invio, un canale che richiede una riconnessione al momento della pubblicazione fallisce con reconnect, e rimuovere un canale annulla i suoi post programmati.

Come easyCoexistence segnala un post TikTok fallito?

Tramite la sua coda di pubblicazione, che segue ogni post TikTok dopo la chiamata di pubblicazione, controllando /business/publish/status/ circa ogni 20 secondi fino a PUBLISH_COMPLETE. Lo stato FAILED fa fallire il post, il cui errore riporta il motivo di TikTok tra parentesi, come frame_rate_check_failed, e ogni errore porta un failure_kind:

  • refused: TikTok ha risposto di no, come con lo stato FAILED e il suo motivo.
  • uncertain: la chiamata di pubblicazione non ha ottenuto una risposta chiara, oppure TikTok non ha dato conferma entro 2 ore, quindi il post potrebbe essere online (may_be_published).
  • reconnect: TikTok ha rifiutato il token dell'account, che richiede un nuovo accesso.
  • internal: easyCoexistence è fallito prima di consegnare il post, quindi nulla è stato inviato.

Come si trova e si riprova un post fallito?

Il titolare riceve un'e-mail per un errore rilevato in background, al massimo una per canale ogni 3 ore, e l'URL degli eventi di una piattaforma riceve post.failed. Il post compare sotto Richiede attenzione nella schermata Post, con Riprova, Riconnetti e Ignora, e list_scheduled_posts lo restituisce a Claude o ChatGPT. retry_scheduled_post lo pubblica di nuovo, subito, dai file conservati per 7 giorni dopo un errore; quando may_be_published è true, controlla prima list_social_posts e passa confirm solo se il post manca. Un post che richiede un nuovo file o una nuova didascalia viene invece riprogrammato.

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 }

Errori comuni

  • Riprovare un controllo fallito con lo stesso file. TikTok marca come non ritentabili gli errori di formato, durata, frame rate e dimensione dell'immagine.
  • Riprovare subito spam_risk_too_many_posts. TikTok conta i post via API nelle ultime 24 ore e suggerisce di pubblicare dall'app mobile.
  • Riprovare un post marcato may_be_published senza verificare. TikTok potrebbe averlo già pubblicato; controlla gli ultimi post dell'account, altrimenti va online due volte.
  • Cercare fail_reason nell'API for Business. Il suo endpoint di stato chiama il campo reason; fail_reason appartiene alla Content Posting API.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni e i primi 3 giorni di prova gratuita.

Domande frequenti

Cosa significa picture_size_check_failed su TikTok?

TikTok ha scaricato il post e ha trovato la sua immagine sotto il minimo di 360 pixel in altezza e larghezza; serve un file più grande, perché TikTok marca l'errore come non ritentabile.

Cos'è video_pull_failed?

TikTok non è riuscito a scaricare il video dal suo URL, o non entro il timeout di un'ora. Verifica che l'URL sia pubblico e non limitato in banda, poi riprova.

Quanto dura spam_risk_too_many_posts?

TikTok conta i post fatti tramite API nelle ultime 24 ore, circa 15 al giorno per account, e nel frattempo suggerisce di pubblicare dall'app mobile di TikTok.

easyCoexistence riprova da solo un post TikTok fallito?

No, dopo che TikTok segnala FAILED: il post resta sotto Richiede attenzione e il titolare riceve un'e-mail, e Riprova o retry_scheduled_post lo invia di nuovo.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il