Rate limits por produto
Cada produto da X API tem sua própria abordagem de rate limiting:X API v2
Limites por endpoint baseados em janelas de 15 minutos. Veja tabelas detalhadas e dicas de recuperação.
Enterprise API
Limites personalizados com base no seu contrato enterprise e pacote de dados.
X Ads API
Limites específicos para endpoints de gerenciamento de anúncios e análise.
Como os rate limits funcionam
| Conceito | Descrição |
|---|---|
| Janela de tempo | A maioria dos limites é reiniciada a cada 15 minutos |
| Limites por usuário | Aplicam-se ao usar tokens de usuário OAuth 1.0a ou OAuth 2.0 |
| Limites por app | Aplicam-se ao usar autenticação Bearer Token (somente app) |
| Específicos por endpoint | Cada endpoint tem seu próprio limite |
Verificando seus limites
Toda resposta da API inclui headers que mostram seu status atual de rate limit:| Header | Descrição |
|---|---|
x-rate-limit-limit | Máximo de solicitações permitidas na janela atual |
x-rate-limit-remaining | Solicitações restantes na janela atual |
x-rate-limit-reset | Timestamp Unix de quando o limite é reiniciado |
Erros de rate limit
Quando você excede um rate limit, receberá uma resposta 429 Too Many Requests:Melhores práticas
Faça cache das respostas
Armazene respostas da API localmente para reduzir solicitações repetidas dos mesmos dados.
Use backoff exponencial
Quando atingir o rate limit, espere antes de tentar novamente. Dobre o tempo de espera a cada nova tentativa.
Verifique os headers
Monitore os headers de rate limit para evitar atingir os limites proativamente.
Use streaming
Para dados em tempo real, use filtered stream em vez de fazer polling em endpoints de busca.