EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Limites de taxa da API do TikTok: requisições por conta, app e endpoint

A API for Business do TikTok limita as requisições em três níveis ao mesmo tempo: 40 por minuto por conta autorizada em cada endpoint da Accounts API, um orçamento combinado da Accounts API por app de desenvolvedor de 600 por minuto no Basic e 1,000 acima dele, e limites por endpoint no app de 10 por segundo, 600 por minuto e 864,000 por dia no Basic, subindo para 50 por segundo no Ultimate.

O easyCoexistence publica publicações, lê insights e responde comentários no TikTok para Claude, ChatGPT ou o seu próprio código, por meio da API for Business do TikTok.

40 QPM

Requisições por minuto por conta autorizada do TikTok em cada endpoint da Accounts API, um número único independente do nível do app.

1,000 QPM

Orçamento para todos os endpoints da Accounts API somados por app de desenvolvedor no Advanced, Premium e Ultimate; no Basic são 600.

50 QPS

Limite por endpoint no Ultimate, o nível mais alto do app, junto de 3,000 requisições por minuto e 4,320,000 por dia.

HTTP 200

Status que o TikTok devolve junto com seus códigos de retorno, incluindo os 4xxxx como 40100; só o código 0 significa sucesso.

10 QPS

Limite de taxa para cada endpoint da Discovery API por app de desenvolvedor.

00:00 UTC

Quando os limites diários são reiniciados; após um limite por minuto, o TikTok pede uma pausa de 5 minutos.

Quais limites se aplicam a uma requisição da API do TikTok?

Até três contadores são acionados a cada requisição da Accounts API, e alguns produtos e ações mantêm contagens próprias. O TikTok mantém os contadores de endpoint independentes, então um endpoint pode ser limitado enquanto os outros do app continuam respondendo:

Per account and endpoint40 queries a minute for each authorized TikTok account on each Accounts API endpoint
Per app, Accounts API combined600 queries a minute at Basic, and 1,000 at Advanced, Premium and Ultimate
Per app and endpointQueries a second, a minute and a day, set by the app's level
PublishingSix posts a minute and 15 a day per account, on the video and on the photo endpoint
Mentions APIThe app's global limits, with TikTok advising one call per endpoint and account a day
Discovery API10 queries a second on each endpoint, per developer app

O que os quatro níveis de app permitem?

Todos os apps de desenvolvedor começam no Basic, e o TikTok sobe o app um nível por vez quando solicitado em My Apps, App Detail, Authorization, com uma justificativa. Cada nível define o que um único endpoint pode receber do app, ao lado do orçamento combinado para requisições da Accounts API:

Basic10 a second, 600 a minute, 864,000 a day; Accounts API combined: 600 a minute
Advanced20 a second, 1,200 a minute, 1,728,000 a day; Accounts API combined: 1,000 a minute
Premium30 a second, 1,800 a minute, 2,592,000 a day; Accounts API combined: 1,000 a minute
Ultimate50 a second, 3,000 a minute, 4,320,000 a day; Accounts API combined: 1,000 a minute

Um nível mais alto eleva o orçamento da Accounts API?

Uma vez. Passar do Basic para o Advanced eleva o orçamento combinado da Accounts API de 600 para 1,000 requisições por minuto, e ele fica em 1,000 até o Premium e o Ultimate, enquanto os limites por endpoint por segundo e por dia continuam subindo. O limite de 40 por minuto por conta e endpoint não muda com o nível, então uma conta muito ativa é limitada a 40 requisições por minuto em um endpoint, seja qual for o nível do app.

Como os limites se somam em muitas contas?

O limite da conta se multiplica a cada conta; o orçamento do app não. Dez contas podem fazer cada uma 40 requisições por minuto para /business/comment/list/, 400 no total, mas vinte fazendo o mesmo precisariam de 800, acima dos 600 que um app Basic tem para as requisições combinadas da Accounts API antes de qualquer outro endpoint ser contado. Acima do Basic, esse orçamento compartilhado chega a no máximo 1,000 por minuto.

O que acontece quando uma requisição passa de um limite?

O TikTok limita esse endpoint. O guia de limites de taxa dele identifica o código 40100 para uma requisição limitada, que chega no corpo de uma resposta HTTP 200, e o endpoint fica fechado por 5 minutos depois de um limite por minuto, ou até os contadores diários zerarem às 00:00 UTC depois de um limite diário, enquanto os demais endpoints do app continuam respondendo. Detectar isso no código e repetir a requisição corretamente são tratados na página do erro 40100.

Os limites de publicação são limites de taxa?

Não, eles contam publicações, e não requisições, e têm página própria. O TikTok permite que uma conta publique seis publicações por minuto e 15 por dia em /business/video/publish/, e o mesmo em /business/photo/publish/. Uma publicação além dessa contagem falha com spam_risk_too_many_posts no status da publicação, enquanto um limite de requisições recusa a própria requisição.

Quais hábitos gastam os limites mais rápido?

Consulta periódica. Verificar um status de publicação ou uma lista de comentários em um timer gasta as 40 requisições por minuto da conta naquele endpoint, independentemente de algo ter mudado, e os webhooks do TikTok existem para substituir isso: os eventos de publicação informam cada etapa de uma publicação, e comment.update avisa sobre um novo comentário em até cinco minutos. Ler em páginas, 20 publicações ou 30 comentários por requisição, e buscar menções uma vez por dia mantém o resto baixo.

Como o easyCoexistence trata uma requisição limitada do TikTok?

Ele repassa a resposta do TikTok em vez de escondê-la. Uma chamada de ferramenta que o TikTok limita, como list_social_comments, reply_to_comment ou get_tiktok_publish_status, volta para a IA como um erro com o código 40100 e a mensagem do TikTok, e não é repetida sozinha. Publicações seguem outro caminho, já que publish_tiktok_post entrega cada uma à fila do easyCoexistence, agora ou em um horário definido:

  • A fila aguarda e repete após 5 minutos, 30 minutos e 2 horas quando a resposta vem como HTTP 429.
  • O TikTok envia 40100 dentro de uma resposta HTTP 200, então uma publicação limitada falha com a mensagem do TikTok e fica em Needs attention para Retry.
  • Um 40100 em uma das verificações de status da fila também falha a publicação, embora o TikTok talvez já a tenha publicado: confira as publicações mais recentes da conta antes de Retry.
  • Uma publicação que falha em segundo plano envia um e-mail ao dono, no máximo uma vez por canal a cada 3 horas.

Quais chamadas do TikTok o easyCoexistence faz para uma conta?

Poucas, e elas contam contra os limites da conta do mesmo jeito que as suas requisições:

  • /business/get/ aproximadamente a cada 6 horas, para verificar se a conta ainda responde.
  • Uma chamada de publicação para cada publicação, depois /business/publish/status/ aproximadamente a cada 20 segundos, até o TikTok concluir ou falhar a publicação, por até 2 horas.
  • Com regras de comentário ou automações ativas, uma chamada a /business/comment/list/ por novo comentário de primeiro nível para ler o autor, e uma chamada para cada resposta publicada.
  • Chamadas de ferramenta só quando a IA ou o seu código pedem, com 20 publicações ou 30 comentários por leitura.

Erros comuns

  • Detectar limitação pelo status HTTP. O TikTok responde 40100 com HTTP 200, então uma checagem de res.ok ou de 429 não o percebe; leia o código no corpo.
  • Subir o nível do app para resolver uma conta muito ativa. Os 40 por minuto por conta e endpoint são os mesmos nos quatro níveis, então distribua as requisições dessa conta ao longo do tempo.
  • Buscar dados de Mentions muitas vezes por dia. O TikTok os atualiza uma vez, entre meia-noite e 7h UTC, e recomenda uma requisição por endpoint e conta por dia.
Fazendo isso com o EasyCoexistence

Quando uma requisição é limitada, devolve o código e a mensagem do TikTok, e acompanha cada publicação até o TikTok concluí-la ou falhar. De US$ 9 (R$ 29,90) a US$ 0.75 (R$ 3,90) por conexão por mês, caindo à medida que você adiciona conexões, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Qual é o limite de taxa da API do TikTok por conta?

40 requisições por minuto em cada endpoint da Accounts API para cada conta autorizada do TikTok, dentro do orçamento combinado do app de desenvolvedor de 600 por minuto no Basic ou 1,000 acima disso.

Os limites de taxa do TikTok são contados por endpoint?

Sim. O guia do TikTok diz que os limites específicos de cada endpoint são independentes, então atingir o limite de um endpoint não impede chamadas a outro.

Como aumento meu limite de taxa da API do TikTok?

Solicite em My Apps, App Detail, Authorization e informe um motivo. Os níveis sobem um passo por vez, do Basic para o Advanced, depois Premium e Ultimate.

As chamadas feitas pelo easyCoexistence contam nos limites do TikTok?

Sim. Elas rodam como a conta conectada, com o token dela, então contam nas 40 requisições por minuto por endpoint como qualquer outra requisição daquela conta.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em