Auditoría del sitio web

Ejecuta una auditoría web completa y devuelve las puntuaciones de Rendimiento, SEO, Accesibilidad y Buenas prácticas (0-100 cada una) con correcciones generadas por IA adaptadas a la tecnología detectada.

POST/api/auditsynchronous

Puntuaciones de rendimiento, problemas de SEO y recomendaciones de IA

Cuerpo de la solicitud

{
  "url": "https://example.com",
  "budget": { ... }   // optional, see below
}

Respuesta

{
  "reportId": "clxyz...",
  "url": "https://example.com",
  "performanceScore": 91,
  "seoScore": 87,
  "accessibilityScore": 100,
  "bestPracticesScore": 95,
  "issues": [...],
  "recommendations": [...],
  "fixes": [...],
  "aiSummary": "...",
  "techStack": [...],
  "perfBudget": { ... },
  "budgetViolations": [...]  // when a budget was sent
}

Ejemplo

curl -X POST https://www.scanverra.com/api/audit \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Presupuestos de rendimiento

Cada respuesta de la API incluye perfBudget: límites basados en esta auditoría (+10 % o un margen mínimo) y los servicios externos encontrados. Guárdalo y envíalo como budget en auditorías posteriores para recibir budgetViolations: lo que sea más lento, más pesado o un servicio externo nuevo. La CLI lo hace con scanverra audit --save-budget y --budget.

"perfBudget": {
  "version": 1,
  "device": "desktop",
  "metrics": { "lcp": 2600, "tbt": 250, "cls": 0.05, "fcp": 1400 },
  "transferBytes": 1843200,
  "scriptBytes": 921600,
  "requestCount": 62,
  "vendors": ["Google Analytics", "Hotjar"]
}

"budgetViolations": [
  { "key": "lcp", "limit": 2600, "actual": 3120 },
  { "key": "vendor", "limit": "not in budget", "actual": "Intercom" }
]

Reauditorías en el plan Free

Las cuentas gratuitas tienen 5 auditorías al mes sin espera. Después, volver a auditar el mismo sitio en menos de 15 minutos devuelve 429 con code: "SCAN_COOLDOWN" y un encabezado Retry-After (segundos). Los planes de pago nunca esperan.

Convención de puntuación

Cada puntuación va de 0 a 100. La interfaz de Scanverra considera ≥90 como bueno, 50-89 como mejorable y <50 como deficiente. Este endpoint no tiene un umbral de aprobado/suspenso integrado: elige tu propio umbral por puntuación al usarlo en un pipeline (consulta Integración CI/CD).

PreviousAuthentication Next Security Scan