# Limiti di richieste (https://docs.getbeel.com/it/api/rate-limits)

120 richieste al minuto per chiave, con header RateLimit e Retry-After.

Ogni chiave API può fare **120 richieste ogni 60 secondi**, in modalità test e live. Il conteggio è per chiave, non per indirizzo IP, e include le chiamate al [server MCP](/it/api/mcp).

## Header [#header]

Ogni risposta indica a che punto sei:

| Header                | Valore                                      |
| --------------------- | ------------------------------------------- |
| `RateLimit-Limit`     | Richieste consentite nella finestra (`120`) |
| `RateLimit-Remaining` | Richieste ancora disponibili                |
| `RateLimit-Reset`     | Secondi alla fine della finestra            |

## Quando superi il limite [#quando-superi-il-limite]

Ricevi `429` con `type: "rate_limit_error"` e `code: "rate_limit_exceeded"`, più un header `Retry-After` con i secondi da attendere.

```js
async function getbeel(path, init = {}) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const res = await fetch(`https://www.getbeel.com/api/v1${path}`, {
      ...init,
      headers: {
        Authorization: `Bearer ${process.env.GETBEEL_API_KEY}`,
        ...init.headers,
      },
    });

    if (res.status !== 429) return res;

    const wait = Number(res.headers.get('Retry-After') ?? '1');
    await new Promise((resolve) => setTimeout(resolve, wait * 1000));
  }

  throw new Error('Getbeel rate limit: too many retries');
}
```

Anche le richieste rifiutate per scope mancante contano nel limite.

Se ti serve un limite più alto, scrivici.
