Endpunkte
Analysiert eine Website und gibt einen AI-Readiness Score mit Kategorie-Ergebnissen und Optimierungsempfehlungen zurück.
Request Body
| Parameter | Typ | Pflicht | Beschreibung |
|---|
url | string | Ja | Die zu prüfende URL. Mit oder ohne https://. |
lang | string | Nein | de oder en — Sprache der Empfehlungen. Standard: en |
Beispiel-Request
cURL
curl -X POST https://tools.soerenmeier.de/api/aicheck/v1/check \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ak_live_xxxxxxxxxxxxxxxx" \
-d '{"url": "https://beispiel.de", "lang": "de"}'
JavaScript
const res = await fetch('https://tools.soerenmeier.de/api/aicheck/v1/check', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer ak_live_xxxxxxxxxxxxxxxx'
},
body: JSON.stringify({ url: 'https://beispiel.de', lang: 'de' })
});
const data = await res.json();
console.log(data.overallScore, data.scoreGrade);
Python
import requests
r = requests.post(
'https://tools.soerenmeier.de/api/aicheck/v1/check',
headers={'Authorization': 'Bearer ak_live_xxxxxxxxxxxxxxxx'},
json={'url': 'https://beispiel.de', 'lang': 'de'}
)
data = r.json()
print(data['overallScore'], data['scoreGrade'])
Beispiel-Response (200 OK)
{
"url": "https://beispiel.de",
"timestamp": "2026-04-06T17:00:00.000Z",
"overallScore": 78,
"scoreGrade": "Needs Improvement",
"categories": {
"structuredData": { "score": 32, "maxScore": 40, "details": { ... } },
"accessibility": { "score": 21, "maxScore": 25, "details": { ... } },
"technical": { "score": 15, "maxScore": 20, "details": { ... } },
"contentQuality": { "score": 10, "maxScore": 15, "details": { ... } }
},
"recommendations": [
{
"category": "Technische Basis",
"priority": "hoch",
"issue": "Keine XML-Sitemap gefunden",
"suggestion": "Erstelle eine sitemap.xml für bessere Indexierung",
"codeExample": "..."
}
],
"summary": {
"excellent": false,
"good": true,
"needsImprovement": false,
"keyStrengths": ["Sehr gute strukturierte Daten"],
"criticalIssues": 1
}
}
Antwortfelder
urlstringDie geprüfte URL
timestampstringISO 8601 Zeitstempel der Prüfung
overallScorenumberGesamtscore 0–100
scoreGradestringBewertung: Excellent (≥90), Needs Improvement (≥50), Poor (<50)
categoriesobjectDetailergebnisse für structuredData (40 Pkt), accessibility (25 Pkt), technical (20 Pkt), contentQuality (15 Pkt)
recommendationsarraySortierte Optimierungsempfehlungen mit category, priority, issue, suggestion, codeExample
summaryobjectKurzauswertung mit keyStrengths und criticalIssues