Primeros pasos
Límites de uso
Un único cupo por cuenta, medido por mes, día y hora.
Límites por plan
| Plan | Por mes | Por día | Por hora | Por llamada masiva |
|---|---|---|---|---|
| Free | 30.000 | 1000 | 100 | 100 |
| Starter | 150.000 | Sin tope | 1500 | 500 |
| Pro | 500.000 | Sin tope | 5000 | 1000 |
| Business | 2.000.000 | Sin tope | 20.000 | 2000 |
| Enterprise | A medida | |||
Un solo cupo cubre todos los productos, y cada llamada medida cuenta una vez.
La demo sin clave permite unas 100 solicitudes al día por IP.
Cabeceras de límite
- X-RateLimit-Limit
Cupo mensual.
- X-RateLimit-Remaining
Solicitudes que quedan este mes.
- X-RateLimit-Reset
Cuándo se reinicia el cupo mensual, como marca de tiempo Unix.
- X-RateLimit-Daily-*
Las mismas tres para el tope diario, en los planes que lo tienen.
- X-RateLimit-Hourly-*
Las mismas tres para el límite por hora.
- Retry-After
Segundos hasta que se reinicia el límite alcanzado.
HTTP/2 200
x-ratelimit-meter: request
x-ratelimit-limit: 30000
x-ratelimit-remaining: 25820
x-ratelimit-reset: 1793491200
x-ratelimit-daily-limit: 1000
x-ratelimit-daily-remaining: 788
x-ratelimit-hourly-limit: 100
x-ratelimit-hourly-remaining: 86Cuando se agota un límite
reason
- hourly_limit
Se agotó el límite por hora; se libera dentro de la hora.
- daily_quota
Se agotó el tope diario; se reinicia a medianoche UTC.
- monthly_quota
Se agotó el cupo mensual; se reinicia en tu fecha de reinicio.
- insufficient_for_batch
Una llamada masiva necesitaba más de lo que queda; needed indica cuánto.
{
"error": "rate_limit_exceeded",
"reason": "daily_quota",
"message": "You have used today's 1,000 requests.",
"meter": "request",
"plan": "Free",
"limit": 1000,
"usage": 1000,
"remaining": 0,
"resetDate": "2026-11-01",
"resetAt": "2026-10-07T00:00:00Z",
"retryAfter": 35400,
"softBlock": false,
"upgrade": {
"recommendedPlan": "Starter",
"url": "https://ipscanner.io/pricing",
"message": "You have used 100% of today's request allowance. The Starter plan has no daily cap."
}
}