Audit de site web

Exécute un audit complet du site et renvoie les scores Performance, SEO, Accessibilité et Bonnes pratiques (0-100 chacun) avec des corrections générées par IA adaptées à la stack technique détectée.

POST/api/auditsynchronous

Scores de performance, problèmes SEO et recommandations IA

Corps de la requête

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

Réponse

{
  "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
}

Exemple

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"}'

Budgets de performance

Chaque réponse de l'API contient perfBudget : des limites basées sur cet audit (+10 % ou une marge minimale) et les services tiers trouvés. Enregistrez-le, puis renvoyez-le en budget lors des audits suivants pour obtenir budgetViolations : tout ce qui est plus lent, plus lourd, ou un nouveau service tiers. La CLI le fait avec scanverra audit --save-budget et --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" }
]

Réaudits avec l'offre Free

Les comptes gratuits ont 5 audits par mois sans attente. Ensuite, réauditer le même site en moins de 15 minutes renvoie 429 avec code: "SCAN_COOLDOWN" et un en-tête Retry-After (secondes). Les offres payantes n'attendent jamais.

Convention de notation

Chaque score va de 0 à 100. L'interface de Scanverra considère ≥90 comme bon, 50-89 comme à améliorer et <50 comme mauvais. Ce endpoint n'a pas de seuil réussi/échoué intégré — choisissez votre propre seuil par score lorsque vous l'utilisez dans un pipeline (voir Intégration CI/CD).

PreviousAuthentication Next Security Scan