Limiti di frequenza dell'API TikTok: richieste per account, app ed endpoint
L'API for Business di TikTok limita le chiamate su tre livelli contemporaneamente: 40 al minuto per account autorizzato su ciascun endpoint dell'Accounts API, un budget combinato dell'Accounts API per app sviluppatore di 600 al minuto con Basic e 1.000 dal livello superiore, e limiti per endpoint per app di 10 al secondo, 600 al minuto e 864.000 al giorno con Basic, saliti a 50 al secondo con Ultimate.
easyCoexistence pubblica post, legge le statistiche e risponde ai commenti su TikTok per Claude, ChatGPT o il tuo codice tramite l'API for Business di TikTok, restituisce il codice e il messaggio di TikTok quando una chiamata viene rallentata, e segue ogni post finché TikTok non lo completa o lo fa fallire.
Richieste al minuto per account TikTok autorizzato su ciascun endpoint dell'Accounts API, una cifra unica a parte dal livello dell'app.
Budget per tutti gli endpoint dell'Accounts API combinati per app sviluppatore con Advanced, Premium e Ultimate; Basic ne ottiene 600.
Limite per endpoint con Ultimate, il livello più alto, accanto a 3.000 richieste al minuto e 4.320.000 al giorno.
Stato che TikTok restituisce insieme ai codici di ritorno, inclusi i 4xxxx come 40100; solo il codice 0 indica successo.
Limite di frequenza per ogni endpoint della Discovery API per app sviluppatore.
Quando si azzerano i limiti giornalieri; dopo un limite al minuto, TikTok chiede invece una pausa di 5 minuti.
Quali limiti si applicano a una chiamata dell'API TikTok?
Fino a tre contatori si muovono con ogni chiamata all'Accounts API, e alcuni prodotti e azioni tengono conteggi propri. TikTok mantiene indipendenti i contatori degli endpoint, quindi un endpoint può essere rallentato mentre gli altri endpoint dell'app continuano a rispondere:
Cosa consentono i quattro livelli dell'app?
Tutte le app sviluppatore partono da Basic, e TikTok sposta un'app di un livello alla volta quando viene richiesto in My Apps, App Detail, Authorization, indicando un motivo. Ogni livello stabilisce quanto un singolo endpoint può assorbire dall'app, accanto al budget combinato per le chiamate all'Accounts API:
Un livello più alto aumenta il budget dell'Accounts API?
Una volta sola. Passando da Basic ad Advanced il budget combinato dell'Accounts API sale da 600 a 1.000 richieste al minuto, e resta a 1.000 con Premium e Ultimate, mentre i limiti per endpoint al secondo e al giorno continuano a salire. Il limite di 40 al minuto per account e per endpoint non cambia affatto con il livello, quindi un singolo account molto attivo viene rallentato a 40 chiamate al minuto su un endpoint, a prescindere dal livello dell'app.
Come si sommano i limiti su più account?
Il limite per account si moltiplica con ogni account; il budget dell'app no. Dieci account possono fare ciascuno 40 chiamate al minuto verso /business/comment/list/, per un totale di 400, ma venti che facessero lo stesso ne servirebbero 800, sopra i 600 che un'app Basic ha per le chiamate all'Accounts API complessive, prima ancora di contare altri endpoint. Oltre Basic, quel budget condiviso arriva al massimo a 1.000 al minuto.
Cosa succede quando una chiamata supera un limite?
TikTok rallenta quell'endpoint. La sua guida ai limiti di frequenza indica il codice 40100 per una chiamata rallentata, che arriva nel corpo di una risposta HTTP 200, e l'endpoint resta chiuso per 5 minuti dopo un limite al minuto, oppure fino al ripristino dei conteggi giornalieri alle 00:00 UTC dopo un limite giornaliero, mentre gli altri endpoint dell'app continuano a rispondere. Riconoscerlo nel codice e riprovare correttamente è compito della gestione dell'errore 40100.
I limiti di pubblicazione sono limiti di frequenza?
No, contano i post anziché le chiamate, e hanno una pagina a parte. TikTok consente a un account di pubblicare sei post al minuto e 15 al giorno tramite /business/video/publish/, e lo stesso tramite /business/photo/publish/. Un post oltre quel conteggio fallisce con spam_risk_too_many_posts nel suo stato di pubblicazione, mentre un limite di richieste rifiuta la chiamata stessa.
Quali abitudini consumano i limiti più in fretta?
Il polling. Controllare lo stato di pubblicazione o l'elenco dei commenti a intervalli fissi consuma le 40 chiamate al minuto dell'account su quell'endpoint, che sia cambiato qualcosa o no, e i webhook di TikTok servono proprio a sostituirlo: gli eventi di pubblicazione dei post segnalano ogni fase di un post, e comment.update segnala un nuovo commento entro cinque minuti. Leggere a pagine, 20 post o 30 commenti per chiamata, e richiedere le menzioni una volta al giorno tengono basso il resto.
Come gestisce easyCoexistence una chiamata TikTok rallentata?
Inoltra la risposta di TikTok invece di nasconderla. Una chiamata di strumento che TikTok rallenta, come list_social_comments, reply_to_comment o get_tiktok_publish_status, torna all'AI come errore che indica il codice 40100 con il messaggio di TikTok, e non viene ripetuta da sola. I post seguono un percorso diverso, perché publish_tiktok_post affida ciascuno alla coda di easyCoexistence, subito o a un orario stabilito:
- La coda attende e riprova dopo 5 minuti, 30 minuti e 2 ore quando una risposta torna come HTTP 429.
- TikTok invia 40100 dentro una risposta HTTP 200, quindi una pubblicazione TikTok rallentata fallisce con il messaggio di TikTok e resta in Needs attention in attesa di Retry.
- Un 40100 su uno dei controlli di stato della coda fa fallire anche il post, anche se TikTok potrebbe averlo già pubblicato: controlla gli ultimi post dell'account prima di Retry.
- Un post che fallisce in background invia un'e-mail al titolare, al massimo una volta per canale ogni 3 ore.
Quali chiamate TikTok fa easyCoexistence per un account?
Poche, e contano sui limiti dell'account esattamente come le tue:
- /business/get/ circa ogni 6 ore, per verificare che l'account risponda ancora.
- Una chiamata di pubblicazione per post, poi /business/publish/status/ circa ogni 20 secondi finché TikTok non completa o fa fallire il post, per un massimo di 2 ore.
- Con regole sui commenti o automazioni attive, una chiamata /business/comment/list/ per ogni nuovo commento di primo livello per leggerne l'autore, e una chiamata per ogni risposta pubblicata.
- Chiamate di strumento solo quando l'AI o il tuo codice lo chiedono, con 20 post o 30 commenti per lettura.
Errori comuni
- Rilevare il rallentamento dallo stato HTTP. TikTok risponde 40100 con HTTP 200, quindi un controllo su res.ok o su 429 lo manca; leggi il codice nel corpo.
- Alzare il livello dell'app per risolvere un account molto attivo. I 40 al minuto per account e per endpoint restano uguali a tutti e quattro i livelli, quindi distribuisci nel tempo le chiamate di quell'account.
- Scaricare i dati Mentions molte volte al giorno. TikTok li aggiorna una sola volta, tra mezzanotte e le 7 UTC, e consiglia una chiamata per endpoint e account al giorno.
Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con una prova gratuita di 3 giorni.
Domande frequenti
Qual è il limite di frequenza dell'API TikTok per account?
40 richieste al minuto su ciascun endpoint dell'Accounts API per ogni account TikTok autorizzato, all'interno del budget combinato dell'app sviluppatore di 600 al minuto con Basic o 1.000 sopra.
I limiti di frequenza TikTok si contano per endpoint?
Sì. La guida di TikTok dice che i limiti specifici di endpoint sono indipendenti, quindi raggiungere il limite di un endpoint non blocca le chiamate verso un altro.
Come si alza il limite di frequenza dell'API TikTok?
Richiedilo in My Apps, App Detail, Authorization e indica un motivo. I livelli salgono un passo alla volta, da Basic ad Advanced, poi Premium e infine Ultimate.
Le chiamate tramite easyCoexistence contano ai fini dei limiti TikTok?
Sì. Vengono eseguite come l'account collegato con il suo token, quindi contano sui suoi 40 al minuto per endpoint come qualsiasi altra chiamata di quell'account.
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