Limites de taxa da API do TikTok: pedidos por conta, app e endpoint
A API for Business do TikTok limita as chamadas 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 programador de 600 por minuto no Basic e 1,000 acima, e limites por endpoint de 10 por segundo, 600 por minuto e 864,000 por dia no Basic, subindo para 50 por segundo no Ultimate.
O easyCoexistence publica posts, lê estatísticas e responde a comentários no TikTok para o Claude, o ChatGPT ou o seu próprio código, através da API for Business do TikTok; devolve o código e a mensagem do TikTok quando uma chamada é limitada e acompanha cada publicação até o TikTok a concluir ou falhar.
Pedidos por minuto por conta do TikTok autorizada em cada endpoint da Accounts API, um valor único, independente do nível do app.
Orçamento para todos os endpoints da Accounts API combinados por app de programador nos níveis Advanced, Premium e Ultimate; o Basic tem 600.
Limite por endpoint no Ultimate, o nível mais alto do app, ao lado de 3,000 pedidos por minuto e 4,320,000 por dia.
Estado devolvido pelo TikTok com os seus códigos de retorno, incluindo os 4xxxx como 40100; só o código 0 significa sucesso.
Limite de taxa para cada endpoint da Discovery API por app de programador.
Quando os limites diários são repostos; após um limite por minuto, o TikTok pede uma pausa de 5 minutos em vez disso.
Que limites se aplicam a uma chamada à API do TikTok?
Até três contadores são incrementados em cada chamada à Accounts API, e alguns produtos e ações mantêm contadores próprios. O TikTok mantém os contadores de cada endpoint independentes, pelo que um endpoint pode ser limitado enquanto os restantes endpoints do app continuam a responder:
O que permitem os quatro níveis do app?
Todas as apps de programador começam no Basic, e o TikTok sobe a app um nível de cada vez, quando for pedido em My Apps, App Detail, Authorization, com um motivo. Cada nível define o que um único endpoint pode consumir da app, a par do orçamento combinado para as chamadas à Accounts API:
Um nível mais alto aumenta 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 pedidos por minuto, e mantém-se nos 1,000 no Premium e no Ultimate, enquanto os limites por endpoint por segundo e por dia continuam a subir. O limite de 40 por minuto por conta e endpoint não muda com o nível, pelo que uma conta muito ativa fica limitada a 40 chamadas por minuto num endpoint, qualquer que seja o nível que a app tenha.
Como se somam os limites em várias contas?
O limite por conta multiplica-se por cada conta; o orçamento da app não. Dez contas podem fazer cada uma 40 chamadas por minuto a /business/comment/list/, ou seja 400 no total, mas vinte a fazer o mesmo precisariam de 800, acima dos 600 que uma app Basic tem para as chamadas à Accounts API no total, antes de contar qualquer outro endpoint. Acima do Basic, esse orçamento partilhado chega ao máximo de 1,000 por minuto.
O que acontece quando uma chamada ultrapassa um limite?
O TikTok limita esse endpoint. O guia de limites de taxa do TikTok identifica o código 40100 para uma chamada limitada, que chega no corpo de uma resposta HTTP 200, e o endpoint fica fechado durante 5 minutos após um limite por minuto, ou até os contadores diários serem repostos às 00:00 UTC após um limite diário, enquanto os restantes endpoints do app continuam a responder. Detetar o erro no código e voltar a tentar corretamente são questões associadas ao erro 40100.
Os limites de publicação são limites de taxa?
Não, contam publicações e não chamadas, e têm uma página própria. O TikTok permite a uma conta publicar seis publicações por minuto e 15 por dia através de /business/video/publish/, e o mesmo através de /business/photo/publish/. Uma publicação que ultrapasse essa contagem falha com spam_risk_too_many_posts no seu estado de publicação, ao passo que um limite de pedidos recusa a própria chamada.
Que hábitos gastam os limites mais depressa?
O polling. Verificar o estado de uma publicação ou uma lista de comentários num temporizador gasta os 40 pedidos por minuto da conta nesse endpoint, tenha algo mudado ou não, e os webhooks do TikTok existem para substituir isso: os eventos de publicação comunicam cada fase de uma publicação, e comment.update comunica um novo comentário no prazo de cinco minutos. Ler por páginas, 20 publicações ou 30 comentários por chamada, e obter os dados de Mentions uma vez por dia mantém o resto baixo.
Como o easyCoexistence trata uma chamada limitada pelo TikTok?
Repassa a resposta do TikTok em vez de a esconder. Uma chamada de ferramenta que o TikTok limita, como list_social_comments, reply_to_comment ou get_tiktok_publish_status, chega à IA como um erro com o código 40100 e a mensagem do TikTok, e não é repetida por si só. As publicações seguem outro caminho, já que publish_tiktok_post entrega cada uma à fila do easyCoexistence, de imediato ou a uma hora definida:
- A fila espera e volta a tentar passados 5 minutos, 30 minutos e 2 horas quando a resposta chega como HTTP 429.
- O TikTok envia 40100 dentro de uma resposta HTTP 200, pelo que uma publicação limitada falha com a mensagem do TikTok e fica em Requer atenção à espera de Repetir.
- Um 40100 numa das verificações de estado da fila também falha a publicação, embora o TikTok a possa já ter publicado: confirme as publicações mais recentes da conta antes de Repetir.
- Uma publicação que falha em segundo plano envia um e-mail ao proprietário, no máximo uma vez por canal a cada 3 horas.
Que chamadas ao TikTok faz o easyCoexistence por conta?
Algumas, e contam para os limites da conta como as suas próprias chamadas:
- /business/get/ cerca de cada 6 horas, para confirmar que a conta continua a responder.
- Uma chamada de publicação por publicação, depois /business/publish/status/ cerca de cada 20 segundos até o TikTok concluir ou falhar a publicação, durante até 2 horas.
- Com regras de comentários ou automações ativas, uma chamada a /business/comment/list/ por cada comentário novo de primeiro nível, para ler o autor, e uma chamada por cada resposta publicada.
- Chamadas de ferramentas só quando a IA ou o seu código as pedir, com 20 publicações ou 30 comentários por leitura.
Erros comuns
- Detetar a limitação pelo estado HTTP. O TikTok responde 40100 com HTTP 200, pelo que uma verificação de res.ok ou de 429 não a deteta; leia o código no corpo da resposta.
- Subir o nível da app para resolver uma conta muito ativa. Os 40 pedidos por minuto por conta e endpoint mantêm-se nos quatro níveis, por isso distribua as chamadas dessa conta ao longo do tempo.
- Obter os dados de Mentions várias vezes por dia. O TikTok atualiza-os uma vez, entre a meia-noite e as 7 h UTC, e recomenda uma chamada por endpoint e conta por dia.
De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Qual é o limite de taxa da API do TikTok por conta?
40 pedidos por minuto em cada endpoint da Accounts API por cada conta autorizada do TikTok, dentro do orçamento combinado da app de programador: 600 por minuto no Basic ou 1,000 acima.
Os limites de taxa do TikTok contam por endpoint?
Sim. O guia do TikTok diz que os limites específicos de cada endpoint são independentes, pelo que atingir o limite de um endpoint não impede as chamadas a outro.
Como aumento o meu limite de taxa da API do TikTok?
Candidate-se em My Apps, App Detail, Authorization e indique um motivo. Os níveis sobem um degrau de cada vez, do Basic para o Advanced, depois Premium e por fim Ultimate.
As chamadas feitas através do easyCoexistence contam para os limites do TikTok?
Sim. Correm como a conta ligada, com o seu token, pelo que contam para os 40 pedidos por minuto por endpoint dessa conta, como qualquer outra chamada.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em