Rate Limits

Entenda os rate limits da X API entre tiers de acesso e endpoints, incluindo limites por app vs por usuário, headers de resposta e melhores práticas para retries.

Os rate limits controlam quantas solicitações de API você pode fazer em um determinado período. Eles garantem o uso justo e a estabilidade do sistema em toda a plataforma.

---

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:

x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800

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:

{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

---

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.

---

Próximos passos

Para tabelas detalhadas de rate limit por endpoint, veja a página de rate limits da sua API específica:

• Rate Limits da X API v2
• Rate Limits da X Ads API