Sichtbarkeits-Check API

Prüfen Sie per REST API, wie sichtbar ein Unternehmen online ist — in Firmenverzeichnissen, Social Media und bei KI-Assistenten wie ChatGPT, Gemini und Claude. Sie erhalten einen Gesamt-Score, einen separaten KI-Sichtbarkeits-Score (GEO) und die Treffer je Plattform.

Web-Tool öffnen API-Zugang anfragen

Auth

Partner-API-Key eines Agentur-Kontos (Authorization: Bearer fw_partner_…). Jeder Report ist an den erzeugenden Key gebunden.

Asynchron

Scans werden eingereiht. Rufen Sie den Report per GET ab, bis status COMPLETE oder FAILED ist (beide terminal).

KI-Sichtbarkeit

Eigener kiVisibilityScore zeigt, ob ChatGPT, Gemini und Claude die Firma kennen und empfehlen.

Scan starten

POST /api/v1/presence-scans
Authorization: Bearer fw_partner_...
Idempotency-Key: scan-2026-07-01-muster
Content-Type: application/json

{
  "name": "Muster GmbH",
  "website": "https://www.muster.at",
  "city": "Wien",
  "branche": "Gewerbe und Handwerk"
}

Antwort

{
  "ok": true,
  "token": "x4f8...",
  "status": "PENDING",
  "cached": false,
  "creditsCharged": 1,
  "creditBalance": 41
}

Report abrufen

GET /api/v1/presence-scans/x4f8...
Authorization: Bearer fw_partner_...

{
  "ok": true,
  "token": "x4f8...",
  "status": "COMPLETE",
  "inputName": "Muster GmbH",
  "presenceScore": 34,
  "kiVisibilityScore": 20,
  "createdAt": "2026-06-28T10:00:00.000Z",
  "completedAt": "2026-06-28T10:00:28.000Z",
  "rows": [
    { "platformKey": "google_business", "category": "DIRECTORY", "status": "NOT_FOUND", "url": null },
    { "platformKey": "chatgpt", "category": "AI_VISIBILITY", "status": "UNVERIFIED", "url": null },
    { "platformKey": "facebook", "category": "SOCIAL", "status": "FOUND", "url": "https://facebook.com/..." }
  ]
}

Endpunkte

POST/api/v1/presence-scansNeuen Sichtbarkeits-Scan einreihen.

GET/api/v1/presence-scans/:tokenStatus und vollständigen Report abrufen.

Abrechnung: Nur ein frischer Scan zieht Credits (Antwort: creditsCharged und creditBalance). Ein Cache-Treffer (cached: true, identische Anfrage innerhalb von 7 Tagen) sowie ein am Rate-Limit gescheiterter Scan werden nicht berechnet (creditsCharged: 0). Ohne ausreichendes Guthaben antwortet die API mit 402 (error: "no_credits"). Ein Idempotency-Key bindet die Anfrage an genau einen Scan: Wiederholungen liefern denselben Token und Status mit creditsCharged: 0. Trifft ein paralleler Replay noch vor Abschluss dieser Bindung ein, antwortet die API kurzzeitig mit 409, error: "idempotency_in_progress" und Retry-After: 1. Wiederholen Sie dann denselben Request mit demselben Key. Für alte, noch nicht an einen Scan gebundene Idempotency-Einträge antwortet die API stattdessen mit 409 und error: "idempotency_replay_unavailable"; verwenden Sie dafür einen neuen Idempotency-Key. Zusätzlich greift ein Fair-Use-Limit pro API-Key und ein plattformweiter Stunden-Backstop.

Siehe auch: Firmenprüfung API und der Tools-Überblick.