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. Mit language steuerst du unabhängig vom Zielmarkt die Sprache von Prompts und Ergebnisdarstellung; Standard ist de.
Konfiguration ist nicht gleich reale Abdeckung
/capabilities unterscheidet verfügbare, temporär ausgefallene, budgetierte, deaktivierte, nicht konfigurierte und nicht unterstützte Provider. Visibility-Ergebnisse speichern zusätzlich die tatsächlich erreichte provider_coverage der jeweiligen Ausführung.
/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","language":"de"}'/readiness/scansVerfügbarAgent Readiness
Analysiert, wie gut KI-Agenten eine Website entdecken und sicher nutzen können. Ergebnisse verwenden das Readiness-Schema 2.0.0: foundationenthält den belastbaren Kernscore, adoption fasst ergänzende Signale zusammen und capability_profiles bewertet angebotene Agenten-Schnittstellen. Einzelprüfungen liefern dafür ein eindeutiges finding sowie score_role und standard_maturity.
curl -X POST https://aisichtbarkeit.de/api/v1/readiness/scans \
-H 'Content-Type: application/json' \
-d '{"url":"https://example.de","language":"de"}'Lifecycle, Limits und Fehler
Limits respektieren
X-RateLimit-* zeigt Limit, Restbudget und Reset-Zeit. Bei 429 oder 503 gilt der Retry-After-Header. Bei außergewöhnlich hohen Request-Bursts kann bereits der vorgeschaltete Edge-Schutz mit 429 antworten; dann können die anwendungsspezifischen X-RateLimit-*-Header fehlen.
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.