Cuotas y límites

El uso se rige por dos límites: una cuota mensual (por plan) y un límite por hora. Ambos se aplican por clave API.

Cabeceras de límite#

Cada respuesta incluye tu uso actual para que puedas regular de forma proactiva:

X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 48766
X-RateLimit-Reset: 1751328000
X-Plan: pro

• X-RateLimit-Limit — tu cuota mensual.
• X-RateLimit-Remaining — llamadas restantes en el periodo.
• X-RateLimit-Reset — hora Unix del reinicio.
• X-Plan — tu plan actual.

Cuando alcanzas un límite#

Superar el límite por hora o la cuota mensual devuelve 429 Too Many Requests con la hora de reinicio. Las llamadas a /me no cuentan para tu cuota.

{
  "success": false,
  "error": "Monthly quota exceeded",
  "plan": "free",
  "limit": 1000,
  "resetAt": "2026-07-01T00:00:00.000Z"
}