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ührenAuthentifiziert mit Bearer-API-Schlüssel. PRO- oder Business-Plan erforderlich. Rate Limit: 100 Anfragen / 15 Min., 1000 / 24 Std. pro Schlüssel.
Authentifizierung
BearerBleibt in diesem Browser-Tab und wird nirgends gespeichert. Schlüssel erstellen oder verwalten →
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 6-Stunden-Domain-Cache umgangen und eine neue Analyse gestartet, die eine Analyse Ihres Plans verbraucht. Sind Ihre Analysen aufgebraucht, erhalten Sie das Ergebnis aus dem Cache, falls es eines gibt. 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 OKTop-Level-Schlüssel einer erfolgreichen Audit-Antwort. Verschachtelte Objekte (visibility, files, eeat usw.) folgen derselben Struktur wie im Web-UI und sind in der Live-Antwort oben einsehbar.
| Feld | Typ | Beschreibung |
|---|---|---|
| url | string | Echo der gesendeten URL. Nützlich, wenn ein Agent viele Anfragen parallel stellt. |
| domain | string | Aus url extrahierter Hostname, ohne www.-Präfix. Der Cache arbeitet auf dieser Ebene. |
| geoScore | number | GEO-Score, 0–100: Bereitschaft aus dem On-Page-Audit (bis zu 40) plus Sichtbarkeit aus Zitaten (bis zu 60). |
| scoreSummary | object | Beide Teile des GEO-Scores und die Zahlen dahinter: readinessScore aus auditScore von auditScoreMax, visibilityScore aus citedChecks von checkedChecks. version ist 2. Ältere gespeicherte Analysen haben kein version und nutzen die früheren Felder oder haben gar kein scoreSummary. |
| 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 KI-Tool Ihre Domain aktuell zitiert. Booleans pro Provider: perplexity, openai, gemini, claude. |
| citations | object | Zitat-Snippets jedes KI-Tools, gruppiert nach Provider. Jeder Eintrag hat den Quelltext und die verlinkte URL. |
| files | object | Status jeder KI-Datei (z. B. llmsTxt.present, aiTxt.present). Keine davon bringt Punkte. |
| eeat | object | E-E-A-T-Signalaufschlüsselung: experience, expertise, authoritativeness, trustworthiness. |
| lightAudit | object | Audit-Zusammenfassung: Hinweise, Quick Wins, Crawl-Status. Das Feld score wiederholt den finalen GEO-Score, nicht die Audit-Punkte. |
| 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 6-Stunden-Domain-Cache geliefert; das verbraucht keine Analyse Ihres Plans. 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 Business-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. |