Documentación

Límites de uso

Para garantizar un uso justo y la estabilidad del sistema, nuestra API implementa límites de uso. Los distintos planes de suscripción tienen diferentes límites de uso.

Volumen incluido por plan

Tu volumen mensual viene de tu plan. Es un único cupo compartido por todos los productos, y cada llamada medida cuenta una vez sobre él.

Free: 30.000 solicitudes al mes, unas 1.000 al día de media, sin límite diario.

Planes de pago: Starter 150.000, Pro 500.000 y Business 2.000.000 de solicitudes al mes. Enterprise es ilimitado.

Endpoint de demostración: El endpoint de demostración sin clave permite unas 100 solicitudes al día por dirección IP y no requiere registro.

GET /v1/demo/{ip}

Encabezados de límite de uso

Todas las respuestas de la API incluyen encabezados que proporcionan información sobre el estado actual de tu límite de uso:

X-RateLimit-Limit: Número máximo de solicitudes permitidas en la ventana de tiempo actual

X-RateLimit-Remaining: Número de solicitudes restantes en la ventana de tiempo actual

X-RateLimit-Reset: Momento en que se restablece la ventana de límite de uso (marca de tiempo Unix)

Límite de uso superado

Si superas tu límite de uso, la API devolverá una respuesta 429 Too Many Requests con el siguiente cuerpo:

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "retryAfter": 60
}

Buenas prácticas

Implementa una espera progresiva: Cuando recibas un error de límite de uso, implementa una espera exponencial antes de reintentar.

Almacena las respuestas en caché: Almacena en caché las respuestas de la API siempre que sea posible para reducir el número de solicitudes.