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.

Basis-URL
https://aiready.tools/api/
GET /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

ParameterTypPflichtBeschreibung
urlstringPflichtAbsolute URL der Seite inklusive https://, URL-kodiert.
freshstringoptional1 = heutiges Ergebnis ignorieren und neu analysieren.
curl "https://aiready.tools/api/audit.php?url=https%3A%2F%2Fexample.com%2F"

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

CodeBedeutung
400Parameter url fehlt oder ist ungültig
429Fair-Use-Grenze erreicht ("status": "rate_limited", retry_after in Sekunden)
500Audit 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.jsonOpenAPI-3.1-Beschreibung dieses Endpunkts
/.well-known/ard.jsonManifest 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/