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.

EndpointLimiteCosa significa in pratica
Direct Post (/v2/post/publish/video/init/)6 richieste / minuto per user access tokenIl 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 Info20 richieste / minuto per user access tokenVa 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 Status30 richieste / minuto per user access tokenPolling. Trenta al minuto sembrano tante finché non interroghi dieci account ogni due secondi: fanno 300.
/v2/user/info/600 richieste / minutoLetture del profilo.
/v2/video/query/600 richieste / minutoMetriche di video specifici.
/v2/video/list/600 richieste / minutoElenco paginato dei video di un creator.
Limiti pubblicati, letti dalla documentazione per sviluppatori di TikTok il 22 settembre 2026.

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.

EndpointLimiteCosa significa in pratica
Web Events (/pixel/track/) e /pixel/batch/1.000 / secondo · 600.000 / minuto · 86.400.000 / giornoConversioni 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 / giornoConversioni da app mobile.
Offline Events (/offline/track/) e /offline/batch/1.000 / secondo · 600.000 / minuto · 86.400.000 / giornoConversioni in negozio e da CRM inviate a posteriori.
/event/track/1.000 / secondo · 600.000 / minuto · 86.400.000 / giornoL’endpoint della Events API 2.0.
Streaming API10.000 / secondo a Basic, fino a 50.000 a UltimateL’unico limite lato eventi che segue davvero la scala dei livelli.
Limiti della Events API, identici a Basic, Advanced, Premium e Ultimate. Letti dalla documentazione della business API di TikTok il 27 settembre 2026.

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

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 .