Limite Events API di TikTok: 1.000 richieste/s (2026)
Verificato il · fonti elencate in fondo a questa pagina
TikTok applica un limite di frequenza a ogni endpoint separatamente, su una finestra mobile di un minuto. L’endpoint Direct Post consente 6 richieste al minuto per user access token, Query Creator Info ne consente 20, Get Post Status 30, e gli endpoint di lettura di utenti e video (/v2/user/info/, /v2/video/query/, /v2/video/list/) 600 ciascuno. Superarli restituisce HTTP 429 con il codice di errore rate_limit_exceeded. La Events API è un sistema separato su un host separato: 1.000 richieste al secondo, uguali a ogni livello di applicazione, e risponde con il codice 40100 quando viene limitata.
Qual è il limite di frequenza di ogni endpoint dell’API di TikTok?
I limiti sono definiti e applicati per endpoint, non come un unico budget condiviso. Esaurire Direct Post non rallenta Get Post Status, e viceversa.
| Endpoint | Limite | Cosa significa in pratica |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 richieste / minuto per user access token | Il limite vincolante per chi pubblica su più account. Vale per token, quindi per account collegato: dieci account non si dividono sei richieste, ne hanno sei ciascuno. |
| Query Creator Info | 20 richieste / minuto per user access token | Va chiamato prima di ogni post, perché l’interfaccia di pubblicazione deve mostrare le vere opzioni di privacy del creator. Ecco perché una pubblicazione costa almeno due chiamate, non una. |
| Get Post Status | 30 richieste / minuto per user access token | Polling. Trenta al minuto sembrano tante finché non interroghi dieci account ogni due secondi: fanno 300. |
| /v2/user/info/ | 600 richieste / minuto | Letture del profilo. |
| /v2/video/query/ | 600 richieste / minuto | Metriche di video specifici. |
| /v2/video/list/ | 600 richieste / minuto | Elenco paginato dei video di un creator. |
Come viene calcolata la finestra, e cosa succede se la superi?
Il calcolo usa una finestra mobile di un minuto, non il minuto fisso dell’orologio. Una raffica di sei post alle 10:00:59 non si azzera alle 10:01:00: continua a contare fino alle 10:01:59.
Oltre la soglia, l’API risponde HTTP 429 con il codice di errore rate_limit_exceeded. TikTok indica che i limiti possono essere alzati su richiesta tramite la sua pagina di supporto, con una valutazione caso per caso.
La conseguenza pratica per chi pubblica su più account: un nuovo tentativo dopo un 429 deve aspettare, non ripetere subito. Un nuovo tentativo immediato allunga proprio la finestra da cui cerca di uscire.
Qual è il limite di frequenza della Events API di TikTok, in richieste al secondo?
Mille al secondo, ed è lo stesso numero per ogni applicazione sviluppatore: è l’unico punto in cui TikTok non ti fa chiedere di più.
È un’API diversa da tutti gli endpoint qui sopra, ed è proprio questo che trae in inganno. Gli endpoint di Content Posting stanno su developers.tiktok.com e si contano al minuto, per user access token. La Events API fa parte della Marketing API su business-api.tiktok.com e si conta in QPS, QPM e QPD sulla tua applicazione sviluppatore. Due host, due sistemi, due codici di errore: la Marketing API risponde "code": 40100 dove l’API per sviluppatori risponde HTTP 429.
La tua applicazione si trova inoltre a uno di quattro livelli globali (Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50) e ogni app parte da Basic. Gli endpoint Events sono esplicitamente esclusi da questa scala: TikTok indica che non serve chiedere un cambio di livello per la Events API, perché il limite è lo stesso per tutti i livelli. Quindi i 1.000 QPS qui sotto sono ciò che riceve un’app nuovissima fin dal primo giorno.
| Endpoint | Limite | Cosa significa in pratica |
|---|---|---|
| Web Events (/pixel/track/) e /pixel/batch/ | 1.000 / secondo · 600.000 / minuto · 86.400.000 / giorno | Conversioni web lato browser e lato server. Il valore giornaliero è esattamente 1.000 × 86.400, quindi il limite al secondo è l’unico che puoi realisticamente raggiungere. |
| App Events (/app/track/) e /app/batch/ | 1.000 / secondo · 600.000 / minuto · 86.400.000 / giorno | Conversioni da app mobile. |
| Offline Events (/offline/track/) e /offline/batch/ | 1.000 / secondo · 600.000 / minuto · 86.400.000 / giorno | Conversioni in negozio e da CRM inviate a posteriori. |
| /event/track/ | 1.000 / secondo · 600.000 / minuto · 86.400.000 / giorno | L’endpoint della Events API 2.0. |
| Streaming API | 10.000 / secondo a Basic, fino a 50.000 a Ultimate | L’unico limite lato eventi che segue davvero la scala dei livelli. |
Perché pubblicare su dieci account non richiede dieci volte il tempo?
Perché ogni limite qui sopra è legato a uno user access token, e un token corrisponde a un account collegato. Dieci account sono dieci contenitori indipendenti da sei post al minuto.
Quello che si mette in fila è la tua infrastruttura: un file video caricato dieci volte sono dieci trasferimenti. Il limite che colpisce per primo non è quasi mai quello di TikTok, è la banda.
Domande frequenti
- I limiti di frequenza dell’API di TikTok valgono per app o per utente?
- Gli endpoint di Content Posting sono documentati per user access token, quindi per account collegato. TikTok non pubblica un tetto separato a livello di app per questi endpoint e indica che i limiti sono definiti e applicati separatamente per ogni API.
- Che errore restituisce TikTok quando si supera un limite di frequenza?
- Lo stato HTTP 429, con il codice di errore rate_limit_exceeded nel corpo della risposta.
- Si possono aumentare i limiti di frequenza dell’API di TikTok?
- Sì. La documentazione di TikTok indica che si possono chiedere limiti più alti tramite la sua pagina di supporto, e che ogni richiesta viene valutata.
- Qual è il limite di frequenza al secondo della Events API di TikTok?
- 1.000 richieste al secondo, 600.000 al minuto e 86.400.000 al giorno, allo stesso modo per /event/track/, Web Events, App Events e Offline Events. TikTok applica lo stesso valore a tutti e quattro i livelli di applicazione e indica che non serve chiedere un aumento per la Events API.
- Il limite della Events API è lo stesso della Content Posting API?
- No, e non sono nemmeno lo stesso sistema. Content Posting è documentata su developers.tiktok.com, si conta al minuto su uno user access token e risponde HTTP 429 con rate_limit_exceeded. La Events API appartiene alla Marketing API su business-api.tiktok.com, si conta in richieste al secondo, al minuto e al giorno sulla tua applicazione sviluppatore e risponde con il codice 40100.
- Quanti video TikTok posso pubblicare al minuto tramite l’API?
- Sei per account collegato, perché l’endpoint Direct Post consente 6 richieste al minuto per user access token. Su dieci account collegati fanno sessanta, perché ogni account ha il proprio limite.
Fonti
- TikTok for Developers — Rate Limits on API Requests — consultate il .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — consultate il .
- TikTok for Developers — Content Posting API, Direct Post — consultate il .
- TikTok for Developers — Query Creator Info — consultate il .
Questi dati provengono dalla documentazione di un’altra azienda, che può cambiare senza preavviso e che qui nulla verifica in automatico. Per questo ogni fonte riporta la data in cui è stata letta. Le fonti di questa pagina vengono rilette ogni trimestre.
Come è stata fatta questa pagina: scritta con l’aiuto dell’IA a partire dalle fonti citate in questa pagina, consultate il .