Skip to content
SEO Optimizer is live, Audit on page SEO and AI-search readiness. Try it free
Anmelden
Website Audit

API-Referenz

Website-Audit

Führt eine vollständige Website-Prüfung durch und liefert die Werte für Performance, SEO, Barrierefreiheit und Best Practices (jeweils 0-100) mit KI-generierten Korrekturen, zugeschnitten auf den erkannten Tech-Stack.

POST/api/auditsynchronous

Performance-Scores, SEO-Probleme und KI-Empfehlungen

Request Body

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

Response

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

Beispiel

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

Performance-Budgets

Jede API-Antwort enthält perfBudget: Grenzwerte auf Basis dieses Audits (+10 % oder ein Mindestabstand) und die gefundenen Drittanbieter. Speichern Sie es und senden Sie es bei späteren Audits als budget zurück, um budgetViolations zu erhalten: alles Langsamere, Schwerere oder ein neuer Drittanbieter. Die CLI macht das mit scanverra audit --save-budget und --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" }
]

Erneute Audits im Free-Tarif

Kostenlose Konten erhalten 5 Audits pro Monat ohne Wartezeit. Danach liefert ein erneutes Audit derselben Website innerhalb von 15 Minuten 429 mit code: "SCAN_COOLDOWN" und einem Retry-After-Header (Sekunden). Kostenpflichtige Tarife warten nie.

Bewertungskonvention

Jeder Wert reicht von 0-100. Die Oberfläche von Scanverra wertet ≥90 als gut, 50-89 als verbesserungswürdig und <50 als schlecht. Dieser Endpunkt hat keine eingebaute Bestanden/Nicht-bestanden-Schwelle — legen Sie beim Einsatz in einer Pipeline Ihre eigene Schwelle pro Wert fest (siehe CI/CD-Integration).