Errores de API y límites de velocidad
Códigos de estado, formas de error y límites de solicitudes para la API Serpfull.
Los errores devuelven { "error": { "code": "…", "message": "…", "details": … } } con un estado HTTP coincidente.
- 400 invalid_parameter: un parámetro de consulta como desde, hasta o resultado tiene un formato incorrecto.
- 401 no autorizado: clave faltante, inválida o revocada.
- 403 plan_required: el acceso a la API necesita un plan Scale o superior en al menos un sitio web.
- 403 alcance_insuficiente: la clave es de solo lectura.
- 429 cooldown, concurrency, daily_quota, Monthly_quota, competidor_quota o host_busy: se aplica un límite de auditoría SEO; consulte retry_at y Retry-After.
- 403 org_suspended: póngase en contacto con el soporte.
- 404 not_found: el recurso no existe en su organización.
- Conflicto 409: el término de búsqueda ya existe para ese país y dispositivo.
- 422 validation_failed / limit_exceeded / plan_required / project_unverified: ver mensaje y detalles.
- 429 rate_limited: espere segundos de reintento después.
- 500 error_interno: inténtalo de nuevo; póngase en contacto con el soporte si persiste.
- 503 no disponible: la API no está disponible temporalmente; Vuelva a intentarlo con retroceso.
Límites de tarifas
120 solicitudes por minuto por clave. Una respuesta 429 incluye Reintentar después: 60. Cada solicitud se registra con la clave y la hora de última utilización de la clave (actualizada como máximo una vez por minuto) se muestra en Configuración → Claves API.
Límites del plan
Agregar o cambiar términos nunca reduce silenciosamente sus números: si una solicitud supera el término de búsqueda del sitio web o el límite de clics por día, falla con 422 y le indica cuánto queda.
Actualizado