API-Playground

Führen Sie ein Live-Audit gegen die visible4ai-Analyse-API direkt aus dem Browser aus. Vollständige Referenz ansehen.

POST/api/v1/analyseSichtbarkeits-Audit für eine URL durchführen

Authentifiziert mit Bearer-API-Schlüssel. Pro- oder Enterprise-Plan erforderlich. Rate Limit: 100 Anfragen / 15 Min, 1000 / 24 Std pro Schlüssel.

Authentifizierung

Bearer

Wird nur in Ihrem Browser-Tab eingegeben. Nie persistiert. Schlüssel erstellen oder verwalten →

API-Schlüssel

Request-Body

application/json

Feld	Typ	Pflicht	Beschreibung
url	string	Pflicht	Absolute URL für das Audit. Muss http oder https nutzen und auf einen öffentlichen Host zeigen.
fresh	boolean	Optional	Bei true wird der 24-Stunden-Domain-Cache umgangen und ein neuer Crawl erzwungen. Standard false.

Beispiel

json

{
  "url": "https://example.com",
  "fresh": false
}

Ausprobieren

Server-Antwort

Noch keine Anfrage gesendet. Füllen Sie das Formular oben aus und klicken Sie auf Ausführen.

Antwortfelder

200 OK

Top-Level-Schlüssel einer erfolgreichen Audit-Antwort. Verschachtelte Objekte (visibility, files, eeat usw.) folgen derselben Struktur, die das Web-UI verwendet — in der Live-Antwort oben einsehbar.

Feld	Typ	Beschreibung
url	string	Echo der gesendeten URL. Nützlich, wenn ein Agent viele Anfragen parallel fächert.
domain	string	Aus `url` extrahierter Hostname, ohne `www.`-Präfix. Cache und Rate Limit deduplizieren auf dieser Ebene.
geoScore	number	Gesamt-GEO-Score, 0–100. Kombiniert AI-Discovery-Dateien, E-E-A-T-Signale, Robots-Berechtigungen und Zitations-Sichtbarkeit.
title	string	Das `<title>`-Tag der Seite, getrimmt.
metaDescription	string	Der `<meta name="description">`-Inhalt der Seite, getrimmt.
summary	string	Ein Absatz mit der Zusammenfassung der Audit-Ergebnisse, in einfacher Sprache.
visibility	object	Ob jedes LLM Ihre Domain aktuell zitiert. Booleans pro Provider: `perplexity`, `openai`, `gemini`, `claude`.
citations	object	Zitat-Snippets jedes LLM, gruppiert nach Provider. Jeder Eintrag hat den Quelltext und die verlinkte URL.
files	object	Status jeder AI-Discovery-Datei (z. B. `llmsTxt.present`, `aiTxt.present`, `ecpJson.present`). Insgesamt 10 Einträge.
eeat	object	E-E-A-T-Signalaufschlüsselung: `experience`, `expertise`, `authoritativeness`, `trustworthiness`.
lightAudit	object	Seiten-Audit-Teilmenge (Score, Überschriften, Schema-Markup, Inhaltstiefe, …). Leichter als das vollständige Datei-/Zitations-Audit.
recommendations	array	Priorisierte Quick Wins. Jeder Eintrag hat `title`, `priority` (high / medium / low) und einen kurzen erklärenden Absatz.
_cached	boolean	`true` wenn aus dem 24-Stunden-Domain-Cache geliefert. Senden Sie `"fresh": true` im Request-Body, um den Cache zu umgehen.
_cacheExpiresAt	number	Unix-Millisekunden, bis der Cache-Eintrag ausläuft. Nur vorhanden, wenn `_cached` `true` ist.

Antworten

Status	Bedeutung
200	Erfolgreiches Audit. JSON-Payload mit geoScore, files, citations, recommendations, _cached, _cacheExpiresAt.
400	Fehlende, fehlerhafte oder nicht öffentliche URL im Request-Body.
401	Fehlender, ungültiger oder widerrufener API-Schlüssel.
403	Konto hat keinen Pro- oder Enterprise-Plan.
413	Request-Body überschreitet das 16-KB-Limit.
429	Rate Limit pro Schlüssel erreicht. Retry-After-Header beachten.
502	Vorübergehender Crawl- oder Analyse-Fehler. Erneut versuchen; bei Wiederholung Support kontaktieren.