Endpoints

GET /v1/validate
Validates the llms.txt of a domain and returns score, grade and detailed check results.

Parameters

ParameterTypeRequiredDescription
domainstringYesDomain to check. With or without https://, with or without www.

Example request

HTTP
GET https://llmshub.de/api/v1/validate?domain=llmshub.de
cURL
curl "https://llmshub.de/api/v1/validate?domain=llmshub.de"
JavaScript
const res = await fetch('https://llmshub.de/api/v1/validate?domain=llmshub.de'); const data = await res.json(); console.log(data.grade, data.score);
Python
import requests r = requests.get('https://llmshub.de/api/v1/validate', params={'domain': 'llmshub.de'}) data = r.json() print(data['grade'], data['score'])

Response

Example response (200 OK)
{ "domain": "llmshub.de", "url": "https://llmshub.de/llms.txt", "score": 100, "max_score": 100, "grade": "A", "status": "conforming", "scoring_version": "2.0", "checks": [ { "id": "reachable", "label": "llms.txt reachable (HTTP 200)", "kind": "basis", "passed": true, "info": "https://llmshub.de/llms.txt", "points": 10, "earned": 10 }, { "id": "content_type", "label": "Content-Type is text/plain or text/markdown", "kind": "basis", "passed": true, "info": "text/plain; charset=utf-8", "points": 5, "earned": 5 } ], "summary": "Your llms.txt has a title, a summary and well-formed link sections." }

Response fields

domainstringThe checked domain
urlstringThe checked URL (domain/llms.txt)
scorenumberScore 0–100
max_scorenumberMaximum score (always 100)
gradestringGrade: A (≥90), B (≥75), C (≥55), D (≥35), F (<35)
statusstringResult: conforming, conforming_with_hints, non_conforming or invalid (unreachable, HTML or empty)
scoring_versionstringVersion of the scoring (currently 2.0)
summarystringShort summary of the result
checksarrayArray of all individual checks (id, label, kind, passed, info, points = maximum points, earned = points earned)
GET /v1/health
Returns the API status.
GET https://llmshub.de/api/v1/health Response: {"status":"OK","service":"llmshub API","version":"1.0","port":8000}

Live test

Try the API directly

Rate limits & terms of use

The API is free and usable without registration. To ensure fair access for everyone the following limits apply:

60
Requests per hour per IP
429
HTTP status when exceeded
8s
Timeout per request

The API may be used in your own tools, projects and integrations. Attribution to llmshub.de is appreciated but not required.