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

# Límites

> Cuántos pedidos acepta una clave por minuto y cómo saber cuántos te quedan.

Cada clave tiene su propio límite: **100 pedidos de lectura por minuto**. Una lectura es todo pedido
`GET`, con o sin `expand[]`. Las claves de prueba tienen el mismo límite que las de producción.

El uso de la API no se cobra por pedido.

## Los headers

Cada respuesta a un pedido aceptado dice cómo vas. Las respuestas de error de autenticación, permisos o ruta no traen estos headers:

```
RateLimit-Policy: "read";q=100;w=60
RateLimit: "read";r=97;t=42
```

* `RateLimit-Policy`: el límite (`q`, pedidos) por ventana (`w`, segundos).
* `RateLimit`: cuántos pedidos te quedan en esta ventana (`r`) y en cuántos segundos se renueva (`t`).

## Cuando te pasas

La respuesta es `429` con el código [`rate_limited`](https://docs.craqui.com/errors/rate_limited) y el header `Retry-After`,
con los segundos que tienes que esperar:

```
HTTP/1.1 429 Too Many Requests
Retry-After: 18
```

Espera esos segundos antes de reintentar. Si te pasa seguido:

* Pide páginas grandes (`limit=100`) en vez de muchas chicas.
* Usa `expand[]` para traer objetos relacionados en el mismo pedido, en vez de pedirlos uno por uno.
* Reparte las sincronizaciones grandes en el tiempo, y no las corras todas a la misma hora.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.