SerpBase

Claves de API y límites

Cada solicitud se autentica con una clave de API y cuenta para las solicitudes por segundo de tu cuenta.

Cómo enviar la clave

Pon la clave en la cabecera X-API-Key de cada solicitud. Las claves en la URL se rechazan para que no acaben en registros de proxies o navegadores. Crea, renombra y revoca claves en la página Claves de API del panel.

BASH
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: YOUR_API_KEY"

Límites de solicitudes

Una solicitud por encima del límite se rechaza al instante con status 1029 y una cabecera Retry-After, y no se cobra. X-RateLimit-Limit y X-RateLimit-Remaining en cada respuesta ayudan a tu cliente a regular el ritmo.

Aumentos automáticos de QPS

Tras confirmar el abono, el total elegible USD eleva QPS al menos a: $3 → 2, $50 → 5, $100 → 10, $200 → 15, $1,000 → 50, $10,000 → 500. Menos de $3 no cambia el límite. Nunca reduce uno superior; no es ilimitado.

Recargas elegibles acumuladas (USD)QPS mínimo tras el aumento
≥ $32 QPS
≥ $505 QPS
≥ $10010 QPS
≥ $20015 QPS
≥ $1,00050 QPS
≥ $10,000500 QPS

Solo cuentan pagos USD credit_pack y auto_topup con abono confirmado. Se excluyen suscripciones (incluido Starter Boost), regalos y códigos. El saldo no equivale a pagos USD acumulados. Otras monedas no se cuentan como USD sin conversión.

Todas las claves, productos y gateways de una cuenta comparten un límite QPS. Crear más claves no lo aumenta.

El aumento se aplica tras confirmar el abono, no solo al volver del pago. El límite actual es el informado por el servidor en tu cuenta; la sincronización de claves puede tardar.

Saldo de la cuenta

Consulta el saldo actual de créditos de la cuenta asociada a una API key activa. Esta solicitud no consume créditos de búsqueda.

GET
0 credits
/account/credits

Envía la clave en el encabezado X-API-Key. No se aceptan API keys en los parámetros de la URL.

BASH
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: your_api_key"
JSON
{
  "status": 0,
  "credits": 12345,
  "permanent_credits": 10000,
  "expiring_credits": 2345,
  "expiring_expires_at": 1798761600
}

El endpoint está limitado a 60 solicitudes por minuto y cuenta. expiring_expires_at es una marca Unix en segundos y vale 0 si no hay créditos temporales activos.