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 | Yes | The URL to check. With or without https://. |
lang | string | No | 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": 35, "details": { ... } },
"accessibility": { "score": 21, "maxScore": 20, "details": { ... } },
"technical": { "score": 15, "maxScore": 20, "details": { ... } },
"contentQuality": { "score": 10, "maxScore": 10, "details": { ... } },
"eeat": { "score": 11, "maxScore": 15, "details": { ... } }
},
"recommendations": [
{
"category": "Technical Foundation",
"priority": "high",
"issue": "No XML sitemap found",
"suggestion": "Create a sitemap.xml for better indexing",
"codeExample": "..."
}
],
"summary": {
"excellent": false,
"good": true,
"needsImprovement": false,
"keyStrengths": ["Very good structured data"],
"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 (35 pts), accessibility (20 pts), technical (20 pts), contentQuality (10 pts), eeat (15 pts)
recommendationsarraySorted optimization recommendations with category, priority, issue, suggestion, codeExample
summaryobjectShort evaluation with keyStrengths und criticalIssues
