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

# Cuotas y límites

> 5 000 peticiones por hora, reiniciadas al inicio de cada hora UTC.

La cuota es de **5 000 peticiones por hora** en todos los planes. Se reinicia **al inicio de cada hora (UTC)**.

## Headers de cuota

Cada respuesta autenticada lleva:

| Header              | Descripción                                                             |
| ------------------- | ----------------------------------------------------------------------- |
| `X-Quota-Limit`     | Tu tope horario (5000).                                                 |
| `X-Quota-Remaining` | Peticiones restantes para la hora UTC en curso.                         |
| `X-Quota-Cost`      | Coste de esta petición (1).                                             |
| `X-Rows`            | Número de líneas devueltas (informativo, si ≥ 1).                       |
| `Retry-After`       | Únicamente en las respuestas `429`: segundos hasta la próxima hora UTC. |

## Superación (429)

Una vez agotada la cuota, las peticiones devuelven `429` hasta el reinicio:

```json 429 theme={null}
{
  "detail": "Quota de requêtes horaire dépassé",
  "quota": { "limit": 5000, "used": 5000, "period": "2026-07-16T14" }
}
```

El header `Retry-After` indica el número de segundos antes del reinicio (inicio de la hora siguiente, UTC).

## Seguir tu consumo

Tu consumo de la hora en curso también se muestra en tu [área de cliente](https://www.apinn.io/account).