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.
Il campo /business/publish/status/ compare solo quando lo stato è FAILED, con valori come frame_rate_check_failed.
Il nome che la Content Posting API dà allo stesso campo, nelle risposte di /v2/post/publish/status/fetch/.
Timeout di download dopo il quale TikTok fallisce un post con video_pull_failed o photo_pull_failed.
Finestra alla base di spam_risk_too_many_posts; TikTok suggerisce di pubblicare quel post dall'app mobile.
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:
{
"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 found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing 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_failedophoto_pull_faileduna volta che l'URL è pubblico e abbastanza veloce. - Riprova con un nuovo file:
file_format_check_failed,duration_check_failed,frame_rate_check_failedepicture_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_removedespam_risk, come consiglia TikTok, oppurespam_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_URLda un dominio o prefisso che l'app non ha verificato.privacy_level_option_mismatch: unprivacy_levelmancante 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.
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.
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