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 respostas429 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
/infoe uma/tweet-info-bulkcom 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.00permitem outras 20 emT+1.00.
Ao ultrapassar o limite
As chamadas excedentes retornam429 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. PythonOpção 2: tentar novamente após 429
Trate respostas429 com uma breve pausa antes de repetir a chamada.
Python
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.
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
- Paginação: obtenha grandes conjuntos respeitando o limite.
- Códigos de erro: respostas 400, 401, 403, 404, 429 e 500.