> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Limites de taxa

> Como as cotas da API do Croma são agrupadas e reportadas.

## Cotas por organização

Os limites de taxa se aplicam **por organização**, não por chave. Cada chave
emitida para a mesma organização compartilha uma mesma cota, então adicionar
chaves não multiplica a sua cota.

O limite padrão é de **100 solicitações por dia** por organização.
Alguns endpoints têm tetos mais estritos, cada um com sua própria cota:

| Cota               | Limite    | Endpoints                                                                     |
| ------------------ | --------- | ----------------------------------------------------------------------------- |
| Padrão             | 100 / dia | Todos os endpoints de dados por país.                                         |
| Extract e Generate | 60 / hora | [Extract](/pt/guides/global/extract), [Generate](/pt/guides/global/generate). |
| Web Search         | 10 / hora | [Web Search](/pt/guides/global/web-search).                                   |
| Research           | 10 / hora | [Research](/pt/guides/global/research).                                       |

A página de cada endpoint indica seu limite.

As [solicitações em lote](/pt/batch) contam como **uma solicitação por elemento**:
um lote de 10 elementos consome 10 da sua cota, igual a 10 chamadas
individuais.

## Cota nos cabeçalhos de resposta

O estado do limite de taxa vem como cabeçalhos HTTP em cada resposta (não
no corpo):

| Cabeçalho               | Significado                                                                                   |
| ----------------------- | --------------------------------------------------------------------------------------------- |
| `X-RateLimit-Limit`     | Solicitações permitidas na janela atual.                                                      |
| `X-RateLimit-Remaining` | Solicitações restantes antes de ser limitado.                                                 |
| `X-RateLimit-Reset`     | Timestamp ISO em que a janela reinicia.                                                       |
| `X-Request-Id`          | Id único da solicitação (`req_…`); inclua-o nos chamados de suporte.                          |
| `X-Cache`               | `HIT` ou `MISS` em endpoints cacheáveis. Os acertos de cache também contam contra a sua cota. |

## Quando você excede o limite

As solicitações que ultrapassam a cota retornam `429` com um envelope
`rate_limit_error` e um cabeçalho `Retry-After` (segundos):

```json theme={"dark"}
{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Try again in 42 seconds."
  }
}
```

```
Retry-After: 42
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2026-05-23T18:00:00.000Z
```

Espere (faça back off) até `Retry-After` transcorrer (ou `X-RateLimit-Reset`),
depois tente novamente.

<Note>
  O limitador **falha aberto**: se o backend de limite de taxa ficar
  indisponível por um momento, as solicitações passam e nenhum cabeçalho
  `X-RateLimit-*` é emitido. Não dependa de os cabeçalhos estarem sempre
  presentes.
</Note>

<Card title="A seguir: Erros" icon="triangle-exclamation" href="/pt/errors">
  O envelope de erro e cada código de erro.
</Card>