Límites de tasa

Cada clave de API tiene un límite sostenido de peticiones por segundo derivado de tu plan (Free 1 req/s → Max 60 req/s — consulta Precios). Los límites se aplican con un token bucket: se permiten ráfagas hasta tu capacidad por minuto, y luego las peticiones se suavizan a la tasa sostenida.

Cuando estás limitado

{ "error": "rate_limited", "retry_after_ms": 850 }

HTTP 429, error: "rate_limited".
retry_after_ms te indica el tiempo mínimo a esperar antes de reintentar.
La cabecera x-ratelimit-remaining en cada respuesta indica cuántas peticiones quedan este minuto.

Concurrencia

Más allá de la tasa por segundo, hay un tope de peticiones en curso. Si lanzas muchas peticiones a la vez puedes ver:

409 request_in_progress — una petición idempotente idéntica ya está en ejecución.
503 too_many_concurrent_requests — demasiadas peticiones concurrentes en curso; aplica backoff y reintenta.

Gestionar los límites

Respeta retry_after_ms; de lo contrario, usa backoff exponencial con jitter.
Mantén un tope de concurrencia del lado del cliente acorde con la tasa de tu plan.
Los SDKs oficiales reintentan 429/503 automáticamente.