Límites de uso

Para evitar abusos, cada cuenta tiene un límite de frecuencia compartido entre todos sus tokens. Mientras tus llamadas se mantengan dentro de ese límite, el uso de la API no tiene restricciones.

Límite de frecuencia (por cuenta)

El límite de frecuencia se aplica por cuenta y es compartido entre todos los API tokens de esa cuenta: crear más tokens no aumenta el límite. Se controla en varias ventanas de tiempo; si se supera el máximo en cualquiera de ellas, las llamadas siguientes son rechazadas hasta que la ventana se renueva.

Headers de la respuesta

Hoy la API no agrega headers de cuota (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) a ninguna respuesta, ni siquiera al error 429: el limitador que aplica sobre el tráfico autenticado con API token devuelve únicamente el cuerpo JSON que ves más abajo, sin headers adicionales. Si tu integración necesita llevar la cuenta de cuánto le queda de cuota, hoy tiene que hacerlo contando sus propias peticiones contra los límites de la tabla de arriba.

Cuando se supera el límite

Si se supera el límite de frecuencia, la API responde con el código HTTP 429 Too Many Requests. La integración debe esperar y reintentar más tarde.

HTTP/1.1 429 Too Many Requests

{
  "success": false,
  "error": "API rate limit exceeded. Please slow down.",
  "code": "RATE_LIMITED"
}

Buenas prácticas

• Espaciá las peticiones; evitá ráfagas innecesarias.
• Ante un 429, no reintentes de inmediato: la respuesta no incluye un header Retry-After que te diga cuánto esperar, así que aplicá vos una espera progresiva (backoff exponencial) antes de reintentar.
• Para sincronizar muchos registros, usá las operaciones en lote (bulk) en vez de una petición por registro.
• Pedí solo los campos que necesitás con el parámetro fields para respuestas más livianas.
• Cacheá del lado de tu integración los datos que no cambian seguido.

¿Necesitás un límite más alto?

Hoy el límite de frecuencia es el mismo para todas las cuentas y no hay overrides por cuenta configurables desde el panel. Si tu integración necesita un volumen mayor, escribinos a soporte contándonos tu caso de uso para evaluarlo puntualmente.