API-Dokumentation
Ein lesender Endpunkt führt dieselbe Audit-Engine aus wie die Website und liefert das vollständige Ergebnis als JSON. Nutze ihn in Skripten, Reportings oder KI-Agenten. Das Audit misst technische und inhaltliche Signale; dass KI-Assistenten eine Seite nennen oder zitieren, kann es nicht garantieren.
/api/audit.php?url={url}
Prüft eine öffentliche Seite. Der Aufruf ist synchron: Die Antwort enthält das vollständige Ergebnis. Der Server bricht spätestens nach 90 Sekunden ab. Dieselbe URL am selben Tag liefert das zwischengespeicherte Ergebnis ("cached": true).
QUERY-PARAMETER
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
url | string | Pflicht | Absolute URL der Seite inklusive https://, URL-kodiert. |
fresh | string | optional | 1 = heutiges Ergebnis ignorieren und neu analysieren. |
Antwort
Gekürzt. status ist done (bewertet), blocked (Seite nicht messbar, z. B. Bot-Schutz oder Fehlerseite) oder partial (zu viele Module ausgefallen). Bei blocked oder partial ist geo_score null. Ein Modulwert null heißt „nicht gemessen“ – nie als 0 lesen.
"status": "done",
"cached": false,
"url": "https://example.com/",
"domain": "example.com",
"analyzed_at": "2026-11-18T08:00:00+01:00",
"geo_score": 61,
"verdict": "Good",
"not_measured": [],
"modules": {
"citability": { "score": 58, "findings": [...] },
"crawlers": { "score": 100, ... },
"schema": { "score": 72, ... },
"llmstxt": { "score": 100, ... },
"eeat": { "score": 64, ... },
"brand": { "score": 50, ... },
"platforms": { "score": 55, ... },
"agent_pricing": { "applicable": false, ... },
"agent_readiness": { "score": 15, "beta": true, "weight": 0, ... }
},
"action_plan": [ { "priority": "HIGH", "title": "...", "why": "...", "steps": [...], "where": "...", "check": "..." } ],
"meta": { "version": "3.3.0", "duration_ms": 3399 }
}
Fehlercodes
| Code | Bedeutung |
|---|---|
| 400 | Parameter url fehlt oder ist ungültig |
| 429 | Fair-Use-Grenze erreicht ("status": "rate_limited", retry_after in Sekunden) |
| 500 | Audit auf dem Server fehlgeschlagen – später erneut versuchen |
Fair Use
10 Anfragen pro Stunde und IP-Adresse. Für den Audit-Endpunkt gibt es weder einen API-Schlüssel noch einen kostenpflichtigen API-Tarif. Bist du im selben Browser bei aiready.tools angemeldet, erscheinen die Audits zusätzlich in deinem Dashboard-Verlauf.
Beschreibungsdateien
Maschinenlesbare Beschreibungen für Werkzeuge und KI-Agenten:
| /openapi.json | OpenAPI-3.1-Beschreibung dieses Endpunkts |
| /.well-known/ard.json | Manifest nach Agentic Resource Discovery (ARD v0.91), zusätzlich in der robots.txt verlinkt (Agentmap) |
llms.txt-Generator-API
llms.txt-Dateien per API erzeugen ist ein eigener Dienst auf llmstxtgenerator.de (Agency-Lizenzschlüssel im Header X-API-Key). Dokumentation: llmstxtgenerator.de/api-docs/