Limite da Events API do TikTok: 1.000 req/s (2026)
Última verificação · fontes listadas no rodapé desta página
O TikTok limita cada endpoint separadamente, numa janela deslizante de um minuto. O endpoint Direct Post permite 6 requisições por minuto por token de acesso de usuário, o Query Creator Info permite 20, o Get Post Status permite 30 e os endpoints de leitura de usuário e de vídeo (/v2/user/info/, /v2/video/query/, /v2/video/list/) permitem 600 cada. Passou disso, a resposta é HTTP 429 com o código de erro rate_limit_exceeded. A Events API é um sistema à parte, em outro host: 1.000 requisições por segundo, iguais em todos os níveis de aplicação, respondendo com o código 40100 quando limita.
Qual é o limite de taxa de cada endpoint da API do TikTok?
Os limites são definidos e aplicados por endpoint, não como um orçamento compartilhado. Esgotar o Direct Post não deixa o Get Post Status mais lento, e vice-versa.
| Endpoint | Limite | O que significa na prática |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 requisições / minuto por token de acesso de usuário | O limite que realmente pega quem publica em várias contas. É por token, ou seja, por conta conectada — dez contas não dividem seis requisições, cada uma tem seis. |
| Query Creator Info | 20 requisições / minuto por token de acesso de usuário | Chamado antes de cada post, porque a interface de publicação precisa mostrar as opções de privacidade reais do criador. É por isso que um fluxo de publicação custa pelo menos duas chamadas, não uma. |
| Get Post Status | 30 requisições / minuto por token de acesso de usuário | Consulta de status. Trinta por minuto parece generoso até você consultar dez contas a cada dois segundos — isso dá 300. |
| /v2/user/info/ | 600 requisições / minuto | Leituras de perfil. |
| /v2/video/query/ | 600 requisições / minuto | Métricas de vídeos específicos. |
| /v2/video/list/ | 600 requisições / minuto | Listagem paginada dos vídeos de um criador. |
Como a janela é calculada, e o que acontece quando você passa do limite?
O cálculo usa uma janela deslizante de um minuto, não um minuto fixo de relógio. Uma rajada de seis posts às 10:00:59 não zera às 10:01:00 — ela continua contando até 10:01:59.
Acima do limite, a API responde HTTP 429 com o código de erro rate_limit_exceeded. O TikTok informa que os limites podem ser aumentados mediante pedido pela página de suporte, com análise caso a caso.
A consequência prática para quem publica em várias contas: uma nova tentativa depois de um 429 precisa esperar, não repetir. Uma nova tentativa imediata estende a janela da qual ela está tentando sair.
Qual é o limite de taxa da Events API do TikTok, em requisições por segundo?
Mil por segundo, e é o mesmo número para todo aplicativo de desenvolvedor — é o único lugar em que o TikTok não te obriga a pedir mais.
É uma API diferente de todos os endpoints acima, e é aí que muita gente se confunde. Os endpoints de Content Posting ficam em developers.tiktok.com e são contados por minuto, por token de acesso de usuário. A Events API faz parte da Marketing API em business-api.tiktok.com e é contada em QPS, QPM e QPD contra o seu aplicativo de desenvolvedor. Dois hosts, dois sistemas, dois códigos de erro: a Marketing API responde "code": 40100 onde a API de desenvolvedores responde HTTP 429.
Seu aplicativo também fica em um de quatro níveis globais — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50, e todo app começa no Basic. Os endpoints de Events ficam explicitamente fora dessa escada: o TikTok informa que você não precisa pedir mudança de nível de limite para a Events API, porque o limite é o mesmo em todos os níveis. Então os 1.000 QPS abaixo são o que um app recém-criado recebe no primeiro dia.
| Endpoint | Limite | O que significa na prática |
|---|---|---|
| Web Events (/pixel/track/) e /pixel/batch/ | 1.000 / segundo · 600.000 / minuto · 86.400.000 / dia | Conversões web pelo navegador e pelo servidor. O número diário é exatamente 1.000 × 86.400, então o limite por segundo é o único que dá para atingir na prática. |
| App Events (/app/track/) e /app/batch/ | 1.000 / segundo · 600.000 / minuto · 86.400.000 / dia | Conversões de apps móveis. |
| Offline Events (/offline/track/) e /offline/batch/ | 1.000 / segundo · 600.000 / minuto · 86.400.000 / dia | Conversões em loja física e de CRM enviadas depois. |
| /event/track/ | 1.000 / segundo · 600.000 / minuto · 86.400.000 / dia | O endpoint da Events API 2.0. |
| Streaming API | 10.000 / segundo no Basic, até 50.000 no Ultimate | O único limite do lado de eventos que segue a escada de níveis. |
Por que publicar em dez contas não leva dez vezes mais tempo?
Porque cada limite acima vale para um token de acesso de usuário, e um token é uma conta conectada. Dez contas são dez baldes independentes de seis posts por minuto.
O que entra em fila é a sua própria infraestrutura: um mesmo arquivo de vídeo enviado dez vezes são dez transferências. O limite que pega primeiro quase nunca é o do TikTok, é a banda.
Perguntas frequentes
- Os limites de taxa da API do TikTok são por app ou por usuário?
- Os endpoints de Content Posting são documentados por token de acesso de usuário — ou seja, por conta conectada. O TikTok não publica um teto separado por app para esses endpoints, e informa que os limites são definidos e aplicados separadamente para cada API.
- Que erro o TikTok retorna quando um limite de taxa é ultrapassado?
- Status HTTP 429, com o código de erro rate_limit_exceeded no corpo da resposta.
- Os limites de taxa da API do TikTok podem ser aumentados?
- Sim. A documentação do TikTok informa que limites maiores podem ser pedidos pela página de suporte, e que cada pedido é analisado.
- Qual é o limite por segundo da Events API do TikTok?
- 1.000 requisições por segundo, 600.000 por minuto e 86.400.000 por dia, igualmente para /event/track/, Web Events, App Events e Offline Events. O TikTok aplica o mesmo número nos quatro níveis de aplicação e informa que você não precisa pedir aumento para a Events API.
- O limite da Events API é o mesmo da Content Posting API?
- Não, e nem são o mesmo sistema. A Content Posting é documentada em developers.tiktok.com, contada por minuto contra um token de acesso de usuário, e responde HTTP 429 com rate_limit_exceeded. A Events API pertence à Marketing API em business-api.tiktok.com, é contada em requisições por segundo, minuto e dia contra o seu aplicativo de desenvolvedor, e responde com o código 40100.
- Quantos vídeos de TikTok posso postar por minuto pela API?
- Seis por conta conectada, já que o endpoint Direct Post permite 6 requisições por minuto por token de acesso de usuário. Com dez contas conectadas são sessenta, porque cada conta tem o próprio limite.
Fontes
- TikTok for Developers — Rate Limits on API Requests — consultada em .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — consultada em .
- TikTok for Developers — Content Posting API, Direct Post — consultada em .
- TikTok for Developers — Query Creator Info — consultada em .
Estes números vêm da documentação de outra empresa, que pode mudar sem aviso e que nada aqui verifica automaticamente. Por isso cada fonte traz a data em que foi consultada. As fontes desta página são relidas a cada trimestre.
Como esta página foi feita: redigida com ajuda de IA a partir das fontes listadas nesta página, consultadas em .