Rate Limiting

Limite principal (uso contínuo)

Você pode realizar até:

1.000 requisições a cada 5 minutos

O que equivale a aproximadamente:

3 requisições por segundo

Este limite controla o uso regular da API ao longo do tempo.

Limite de proteção contra picos (Burst Limit)

Além do limite principal, existe uma camada adicional de proteção contra picos repentinos de tráfego.

Você pode realizar até:

200 requisições a cada 5 segundos

Esse mecanismo evita que disparos massivos comprometam a estabilidade da plataforma.

Resumo dos limites

Comportamento em caso de excesso

Caso qualquer limite seja excedido, a API retornará:

429 Too Many Requests

Nesse cenário, aguarde alguns segundos antes de realizar novas tentativas.

Repetir chamadas imediatamente pode prolongar o bloqueio temporário.

📘

Escopo

Os limites descritos nesta página são aplicados por conta.

Exemplo de resposta

{
  "status": 429,
  "message": "Too Many Requests"
}

Boas práticas para evitar atingir o limite

Evite loops sem controle

Processos que utilizam:

• for
• while
• foreach
• automações recursivas

devem possuir algum mecanismo de controle de volume.

Implemente Retry com Backoff

Ao receber um erro 429, aguarde alguns segundos antes de tentar novamente.

Exemplo:

1ª tentativa → erro 429
Aguardar 2 segundos

2ª tentativa → erro 429
Aguardar 5 segundos

3ª tentativa → nova tentativa

Distribua as chamadas ao longo do tempo

Evite enviar centenas de requisições simultâneas.

Sempre que possível:

• Agrupe operações.
• Distribua chamadas em lotes.
• Utilize filas de processamento.

Recomendações para N8N

O N8N pode gerar grandes volumes de chamadas sem que isso fique evidente.

As configurações abaixo ajudam a evitar problemas.

Utilize o node Wait

Após chamadas em massa ou dentro de loops, utilize o node Wait para inserir pequenos intervalos.

Exemplo:

500 ms
1000 ms
2000 ms

Mesmo intervalos pequenos já reduzem significativamente os riscos de bloqueio.

Controle a concorrência

Ao utilizar:

• HTTP Request
• Split In Batches
• Loop Over Items

evite executar centenas de itens simultaneamente.

Prefira processamentos sequenciais ou em pequenos lotes.

Configure corretamente o Split In Batches

Boas práticas:

10 itens por lote
20 itens por lote
50 itens por lote

Combine com um node Wait entre os lotes.

Trate explicitamente o erro 429

Fluxo recomendado:

Detectar erro 429
↓
Aguardar alguns segundos
↓
Tentar novamente
↓
Continuar execução

Isso aumenta a estabilidade da automação e evita falhas desnecessárias.

Perguntas Frequentes

O limite é compartilhado entre usuários da mesma conta?

Sim. O limite é aplicado à conta que está utilizando a API.

O limite é aplicado por endpoint?

Não. O consumo considera todas as chamadas realizadas pela conta.

Posso solicitar aumento de limite?

Caso sua operação necessite de volumes superiores aos padrões da plataforma, entre em contato com o nosso time.

O que acontece se eu ultrapassar os limites frequentemente?

Chamadas excedentes serão bloqueadas temporariamente através da resposta:

429 Too Many Requests

Por isso é recomendável implementar mecanismos de retry e controle de volume.