Endpunkte

GET /v1/validate
Validiert die llms.txt einer Domain und gibt Score, Note und detaillierte Prüfergebnisse zurück.

Parameter

ParameterTypPflichtBeschreibung
domainstringJaDomain die geprüft werden soll. Mit oder ohne https://, mit oder ohne www.

Beispiel-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'])

Antwort

Beispiel-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." }

Antwortfelder

domainstringDie geprüfte Domain
urlstringDie geprüfte URL (domain/llms.txt)
scorenumberPunktzahl 0–100
max_scorenumberMaximale Punktzahl (immer 100)
gradestringNote: A (≥90), B (≥75), C (≥55), D (≥35), F (<35)
statusstringErgebnis: conforming, conforming_with_hints, non_conforming oder invalid (nicht erreichbar, HTML oder leer)
scoring_versionstringVersion der Bewertung (aktuell 2.0)
summarystringKurze Zusammenfassung des Ergebnisses
checksarrayArray mit allen Einzelprüfungen (id, label, kind, passed, info, points = Höchstpunktzahl, earned = erreichte Punkte)
GET /v1/health
Gibt den Status der API zurück.
GET https://llmshub.de/api/v1/health Response: {"status":"OK","service":"llmshub API","version":"1.0","port":8000}

Live testen

API direkt ausprobieren

Rate Limits & Nutzungsbedingungen

Die API ist kostenlos und ohne Registrierung nutzbar. Um einen fairen Zugang für alle sicherzustellen gelten folgende Limits:

60
Anfragen pro Stunde pro IP
429
HTTP Status bei Überschreitung
8s
Timeout pro Anfrage

Die API darf in eigenen Tools, Projekten und Integrationen genutzt werden. Eine Nennung von llmshub.de als Quelle ist erwünscht aber nicht verpflichtend.