AI Visibility und Agent Readiness per API
Automatisiere beide Website-Checks über eine gemeinsame, versionierte Schnittstelle. Der öffentliche Zugang funktioniert serverseitig ohne Anmeldung und nutzt bewusst eingeschränkte Kontingente.
Der Einstieg bleibt für beide Checks gleich
Sende eine öffentliche HTTP- oder HTTPS-URL, speichere die zurückgegebene Ressourcen-URL und poll sie mit dem empfohlenen Retry-After-Intervall. Alle Antworten tragen ein request_id zur Fehlersuche.
/visibility/scansVerfügbarAI Visibility
Prüft, ob eine Marke in relevanten KI-Antworten sichtbar wird.
curl -X POST https://aisichtbarkeit.de/api/v1/visibility/scans \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: mein-scan-001' \
-d '{"url":"https://example.de","brand_name":"Example"}'/readiness/scansVerfügbarAgent Readiness
Analysiert, wie gut KI-Agenten eine Website entdecken und sicher nutzen können.
curl -X POST https://aisichtbarkeit.de/api/v1/readiness/scans \
-H 'Content-Type: application/json' \
-d '{"url":"https://example.de"}'Lifecycle, Limits und Fehler
Limits respektieren
X-RateLimit-* zeigt Limit, Restbudget und Reset-Zeit. Bei 429 oder 503 gilt der Retry-After-Header.
Management-Token sichern
Das management_token erscheint nur beim ersten Anlegen. Zum Löschen wird es als X-Scan-Management-Token gesendet.
Idempotent senden
Ein Idempotency-Key gilt 24 Stunden je Produkt und Principal. Derselbe Key mit anderem Payload liefert 409 idempotency_conflict.
Bis zum terminalen Ergebnis pollen
Lies links.self, bis status den Wert succeededoder failed erreicht. Fehler enthalten immer error.code, error.message und error.request_id.