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

API-Referenz

SEO-Optimierer

Analysiert On-Page-SEO, GEO/KI-Suchreife und E-E-A-T-Vertrauenssignale einer Seite, mit optionalem JavaScript-Rendering, Keyword-/Wettbewerbervergleich und Google-Search-Console-Daten.

POST/api/seo-optimizerasync

Startet einen Scan - On-Page-SEO, GEO, E-E-A-T und optionales JS-Rendering

Der Scan läuft im Hintergrund. Frage GET /api/seo-optimizer?id={scanId} ab, bis status auf done oder failed steht.

Request-Body

{
  "url": "https://example.com/page",
  "keyword": "target keyword",
  "competitorUrl": "https://competitor.com/page",
  "renderJs": false
}

Antwort (sofort)

{
  "scanId": "clxyz..."
}

Beispiel

curl -X POST https://www.scanverra.com/api/seo-optimizer \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page","keyword":"widgets"}'
GET/api/seo-optimizersynchronous

Ruft Status und vollständige Ergebnisse eines Scans ab, sobald abgeschlossen

Query-Parameter

?id={scanId}

Antwort

{
  "id": "clxyz...",
  "status": "done",
  "score": 88,
  "pageData": {...},
  "findings": [...],
  "keywordAnalyses": [...],
  "crawlability": {...},
  "aiSuggestions": {...},
  "competitorPageData": {...},
  "competitorFindings": [...]
}

status ist running, done oder failed. pageData, findings und aiSuggestions werden erst befüllt, wenn status auf done steht.

Beispiel

curl "https://www.scanverra.com/api/seo-optimizer?id=clxyz..." \
  -H "X-API-Key: sk_live_..."

Optionale Request-Felder

keyword: kommagetrennte Ziel-Keywords, deren Platzierung/Dichte geprüft wird. competitorUrl: eine zweite URL, die im selben Bericht gescannt und verglichen wird. renderJs: auf true setzen, um die Seite zuerst in einem echten Browser zu rendern - langsamer, erfasst aber Inhalte, die ein einfacher Abruf auf React-/Vue-/SPA-Seiten übersehen würde.