Skip to main content
A Sorsa aplica um limite universal para manter o serviço rápido e estável. Não há faixas por endpoint nem janelas móveis.

A regra: 20 requisições por segundo

Cada chave de API tem limite de 20 requisições por segundo. Não há limites por endpoint, janelas de 15 minutos, reinícios por hora ou diferenças entre os planos padrão. Coordene a frequência total de todos os workers que usam a mesma chave e trate respostas 429 mesmo ao controlar o ritmo localmente.
  • O limite é por chave, não por IP. Cada chave tem sua própria franquia de 20 req/s.
  • Todas as chamadas contam igualmente. Uma consulta /info e uma /tweet-info-bulk com 100 publicações consomem uma requisição cada.
  • A janela não é móvel. O contador reinicia a cada segundo: 20 chamadas em T+0.00 permitem outras 20 em T+1.00.

Ao ultrapassar o limite

As chamadas excedentes retornam 429 Too Many Requests. Não há perda de dados nem penalização da chave. Aguarde o próximo segundo e tente novamente. Não são enviados cabeçalhos x-ratelimit-remaining ou x-ratelimit-reset. Como o limite reinicia a cada segundo, esses contadores acrescentariam complexidade com pouco benefício.

Como respeitar o limite

Em operações comuns, você provavelmente ficará abaixo de 20 req/s. Para lotes grandes, use uma destas abordagens.

Opção 1: espera fixa entre requisições

Em um único worker sequencial, uma pausa de pelo menos 50 ms após cada resposta limita a frequência. Use uma pausa maior para ter margem. Vários workers com a mesma chave precisam de um limitador compartilhado; pausas independentes de 50 ms não controlam o total. Python
JavaScript

Opção 2: tentar novamente após 429

Trate respostas 429 com uma breve pausa antes de repetir a chamada. Python
JavaScript
Combine uma pequena espera preventiva com tratamento de 429 como proteção adicional.

Lotes reduzem a quantidade de chamadas

Antes de aumentar a velocidade, reduza o total de requisições:
  • /info-batch: até 100 perfis por chamada.
  • /tweet-info-bulk: até 100 publicações por chamada.
Uma chamada em lote conta como uma chamada comum, tanto no limite de frequência quanto na cota. Para muitos itens, isso costuma ser mais eficiente que consultas individuais paralelas. Veja otimização do uso da API.

Precisa de um limite maior?

Para volume contínuo acima de 20 req/s, como um pipeline de monitoramento a 100+ req/s, fale com a equipe por Talk to Sales ou Discord sobre planos personalizados e infraestrutura dedicada.

Próximos passos