firmenwebseiten.at

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.

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_...
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
}
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.

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.