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.
Partner-API-Key eines Agentur-Kontos (Authorization: Bearer fw_partner_…). Jeder Report ist an den erzeugenden Key gebunden.
Scans werden eingereiht. Rufen Sie den Report per GET ab, bis status COMPLETE oder FAILED ist (beide terminal).
Eigener kiVisibilityScore zeigt, ob ChatGPT, Gemini und Claude die Firma kennen und empfehlen.
POST /api/v1/presence-scans
Authorization: Bearer fw_partner_...
Content-Type: application/json
{
"name": "Muster GmbH",
"website": "https://www.muster.at",
"city": "Wien",
"branche": "Gewerbe und Handwerk"
}{
"ok": true,
"token": "x4f8...",
"status": "PENDING",
"cached": false
}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
/api/v1/presence-scansNeuen Sichtbarkeits-Scan einreihen./api/v1/presence-scans/:tokenStatus und vollständigen Report abrufen.Identische Anfragen werden 7 Tage gecached (Antwort mit cached: true) und zählen nicht aufs Kontingent. Fair-Use: bis zu 5 neue Scans pro Stunde je API-Key, plus ein plattformweiter Stunden-Backstop — höhere Kontingente auf Anfrage.