Endpoints
Analyzes a website and returns an AI-Readiness score with detailed category results and optimization recommendations.
Request Body
| Parameter | Type | Required | Description |
|---|
url | string | Ja | The URL to check. With or without https://. |
lang | string | Nein | de or en — language of recommendations. Default: en |
Example 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://example.com", "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://example.com', lang: 'en' })
});
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://example.com', 'lang': 'de'}
)
data = r.json()
print(data['overallScore'], data['scoreGrade'])
Example Response (200 OK)
{
"url": "https://example.com",
"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
}
}
Response Fields
urlstringThe checked URL
timestampstringISO 8601 Timestamp of the check
overallScorenumberTotal score 0–100
scoreGradestringRating: Excellent (≥90), Needs Improvement (≥50), Poor (<50)
categoriesobjectDetailed results for structuredData (40 Pkt), accessibility (25 Pkt), technical (20 Pkt), contentQuality (15 Pkt)
recommendationsarraySorted optimization recommendations with category, priority, issue, suggestion, codeExample
summaryobjectShort evaluation with keyStrengths und criticalIssues