Erro 40100 do TikTok: requisições feitas com muita frequência
O erro 40100 do TikTok significa que um limite de taxa barrou a requisição: o TikTok responde com o código 40100 no corpo de uma resposta HTTP 200, então o status sozinho não revela o erro. A solução é pausar as chamadas a esse endpoint, por 5 minutos após um limite por minuto ou até 00:00 UTC após um limite diário, e depois enviar menos requisições, porém maiores.
O easyCoexistence devolve o código e a mensagem do TikTok ao Claude, ao ChatGPT ou ao seu próprio código, para que sua IA diferencie um limite de taxa de uma publicação com falha e espere antes de repetir.
O código que o TikTok retorna quando um limite de taxa é atingido, ou seja, a requisição foi barrada.
O status que o TikTok envia com seus códigos de retorno, incluindo o 40100; só o código 0 no corpo indica sucesso.
O limite de taxa da Accounts API para cada conta autorizada do TikTok, em cada endpoint.
Todos os endpoints da Accounts API somados, por app de desenvolvedor no nível Basic; níveis superiores permitem 1.000.
Quanto tempo o TikTok manda esperar antes de chamar de novo após atingir um limite por minuto.
O máximo de publicações de vídeo que uma conta pode fazer pela API em um dia, com no máximo seis por minuto.
O que significa o erro 40100?
Um limite de taxa barrou a requisição. O apêndice de códigos de retorno do TikTok descreve o 40100 como requisições feitas com muita frequência, porque o limite do endpoint no nível do app de desenvolvedor foi atingido, e o guia de limites de taxa diz que o servidor retorna 40100 assim que um limite é atingido. As chamadas a esse endpoint precisam ficar pausadas até a suspensão terminar.
Como detectar o 40100 no código?
Pelo código no corpo da resposta, não pelo status HTTP. O TikTok envia seus códigos de retorno com HTTP 200, então verifique o campo code em cada resposta: 0 significa sucesso e 40100, uma requisição barrada. Um status 4xx indica caminho ou método incorreto e, em um 5xx, o TikTok recomenda esperar cerca de 5 minutos antes de repetir:
// TikTok returns its error codes with HTTP 200: read code, not only the status.
async function callTikTok(url, accessToken) {
const res = await fetch(url, { headers: { "Access-Token": accessToken } });
if (res.status >= 500) return { retryInMs: 5 * 60_000 }; // TikTok: wait about 5 minutes
if (!res.ok) throw new Error("HTTP " + res.status + ": check the path and the method");
const body = await res.json();
if (body.code === 40100) return { retryInMs: 5 * 60_000 }; // throttled: pause this endpoint
if (body.code !== 0) throw new Error("TikTok " + body.code + ": " + body.message);
return { data: body.data };
}Quais limites podem retornar 40100?
O guia de limites de taxa do TikTok diz que o servidor retorna 40100 assim que um limite de taxa é atingido, e cada limite é contado separadamente, com os números completos por nível de app na página de limites de taxa. Uma chamada da Accounts API entra na contagem de três deles:
- 40 consultas por minuto para cada conta autorizada em cada endpoint da Accounts API, o mesmo valor em todos os níveis de app.
- 600 consultas por minuto no total da Accounts API por app de desenvolvedor no nível Basic, e 1.000 nos níveis acima.
- Limites do app por endpoint, por segundo, minuto e dia, definidos pelo nível do app.
Quanto tempo devo esperar?
Depende do limite atingido. Após um limite por minuto, o TikTok manda esperar 5 minutos antes de chamar de novo. Após um limite diário, espere até o dia seguinte, já que os limites diários zeram às 00:00:00 UTC. O guia do TikTok acrescenta que os limites de cada endpoint são independentes, então atingir o limite de um endpoint não interrompe as chamadas a outro.
O teto de 15 publicações por dia é o mesmo limite?
Não. O teto de publicação conta publicações, seis por minuto e 15 por dia por conta em cada endpoint de publicação, e uma publicação que passa do teto falha no status de publicação com spam_risk_too_many_posts, e não com 40100. A orientação do TikTok para essa falha é publicar pelo app do TikTok no celular, e a página de limites de publicação trata do assunto.
Como ficar abaixo dos limites?
A orientação do TikTok é fazer menos requisições, porém maiores, e limitar quantas rodam ao mesmo tempo. Na Accounts API, isso significa ler até 20 publicações por página de /business/video/list/ e até 30 comentários por página de /business/comment/list/ em vez de buscá-los um a um, espaçar as chamadas com um token bucket ou colocá-las numa fila para que um número fixo de workers as envie, com as tarefas que falham voltando à fila após um intervalo.
Um nível de app mais alto evita o 40100?
Só quando o limite atingido foi um limite do app. Todo app começa no nível Basic, e o TikTok o eleva um nível por vez, de Basic para Advanced, depois Premium e Ultimate, mediante uma solicitação feita em My Apps, App Detail, Authorization, com uma justificativa. O guia da Accounts API do TikTok informa o limite de 40 por minuto por conta e endpoint como um valor único, independente do nível do app, então, para uma conta muito ativa, a solução é espaçar as chamadas dela.
Erros comuns
- Repetir na hora. O endpoint continua limitado até a suspensão terminar, então repetições rápidas gastam chamadas sem conseguir passar.
- Buscar publicações ou comentários um a um. Uma chamada de listagem retorna uma página de até 20 publicações ou 30 comentários, e cada chamada conta para as 40 por minuto.
- Consultar o status de publicação em loop sem intervalo. Cada verificação é uma chamada a /business/publish/status/, e os IDs das publicações podem levar até três minutos para aparecer, então espace as verificações.
- Tratar spam_risk_too_many_posts como limite de taxa. Ele conta as publicações criadas pela API nas últimas 24 horas, não as chamadas por minuto, então desacelerar as chamadas não resolve.
As ferramentas leem comentários em páginas de 30 e publicações até 20 por vez, e publish_tiktok_post avisa a IA de antemão que o TikTok limita a publicação pela API a cerca de 15 publicações por dia por conta. De R$ 29,90 a R$ 3,90 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os 3 primeiros 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
O TikTok retorna HTTP 429 quando uma chamada atinge o limite de taxa?
Os guias do TikTok descrevem uma chamada barrada como código 40100 no corpo de uma resposta HTTP 200 e não citam nenhum status 429, então verifique o campo code em cada resposta.
Quanto tempo dura o bloqueio do erro 40100 do TikTok?
O TikTok manda esperar 5 minutos após atingir um limite por minuto. Um limite diário é liberado às 00:00:00 UTC, quando é zerado.
O easyCoexistence repete automaticamente uma chamada que retorna 40100?
Não por conta própria. Uma chamada de ferramenta barrada volta para a sua IA com o código 40100 e a mensagem do TikTok, e uma publicação barrada na fila falha com essa mensagem e fica em Needs attention até você escolher Retry.
O 40100 é diferente do 40016?
O apêndice do TikTok dá aos dois a mesma descrição, requisições feitas com muita frequência no nível do app de desenvolvedor, e a mesma solução: consultar o guia de limites de taxa. O 40133 se refere ao nível do anunciante.
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