API
llmshub API
Kostenlose REST API zur programmatischen Validierung von llms.txt Dateien – offen, ohne Registrierung, mit Rate Limiting.
Base URL: https://llmshub.de/api/v1
Format: JSON
Auth: Keine
Version: 1.0
Endpunkte
GET
/v1/validate
Validiert die llms.txt einer Domain und gibt Score, Note und detaillierte Prüfergebnisse zurück.
Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
domain | string | Ja | Domain 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.