> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-e187ed14.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

<CardGroup cols={3}>
  <Card title="X API v2" icon="square-x-twitter" href="/x-api/fundamentals/rate-limits">
    Limites por endpoint baseados em janelas de 15 minutos. Veja tabelas detalhadas e dicas de recuperação.
  </Card>

  <Card title="Enterprise API" icon="building" href="/x-api/enterprise-gnip-2.0/fundamentals/rate-limits">
    Limites personalizados com base no seu contrato enterprise e pacote de dados.
  </Card>

  <Card title="X Ads API" icon="rectangle-ad" href="/x-ads-api/fundamentals/rate-limiting">
    Limites específicos para endpoints de gerenciamento de anúncios e análise.
  </Card>
</CardGroup>

***

## 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**:

```json theme={null}
{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}
```

***

## Melhores práticas

<CardGroup cols={2}>
  <Card title="Faça cache das respostas" icon="database">
    Armazene respostas da API localmente para reduzir solicitações repetidas dos mesmos dados.
  </Card>

  <Card title="Use backoff exponencial" icon="clock-rotate-left">
    Quando atingir o rate limit, espere antes de tentar novamente. Dobre o tempo de espera a cada nova tentativa.
  </Card>

  <Card title="Verifique os headers" icon="list-check">
    Monitore os headers de rate limit para evitar atingir os limites proativamente.
  </Card>

  <Card title="Use streaming" icon="signal-stream">
    Para dados em tempo real, use filtered stream em vez de fazer polling em endpoints de busca.
  </Card>
</CardGroup>

***

## 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](/x-api/fundamentals/rate-limits)
* [Rate Limits da X Ads API](/x-ads-api/fundamentals/rate-limiting)