Anleitung · Für Entwickler

VISIWING API

Werte aus VISIWING in eigene Systeme, Dashboards und Abläufe holen. Dieselben Zahlen wie in der App, als JSON.

FürEntwickler, Agenturen, n8n, Make, Zapier, Looker Studio

Adresse der API

https://…/api/v1

Voraussetzungen

  • Ein VISIWING-Konto.
  • Ein API-Schlüssel mit den nötigen Rechten: lesen, messen, fragen.

So geht es

  1. Schlüssel anlegen

    In VISIWING unter Schnittstellen, API einen Schlüssel anlegen und die Rechte wählen. Der Schlüssel erscheint nur einmal.

  2. Erster Aufruf

    Konto, Tarif und Kontingente:

    curl -H "Authorization: Bearer vw_DEIN_SCHLUESSEL" https://…/api/v1/konto

  3. Firmen und Score

    curl -H "Authorization: Bearer vw_DEIN_SCHLUESSEL" https://…/api/v1/firmen
curl -H "Authorization: Bearer vw_DEIN_SCHLUESSEL" https://…/api/v1/firmen/muster-mobility.de

  4. Messung starten (Recht messen)

    Mit derselben client_id startet nichts doppelt. Den Stand liefert GET /messungen/{job_id}.

    curl -X POST -H "Authorization: Bearer vw_DEIN_SCHLUESSEL" -H "Content-Type: application/json" \
  -d '{"domain": "muster-mobility.de", "client_id": "lauf-2026-10-16"}' \
  https://…/api/v1/messungen

  5. Alle Endpunkte

    Die Doku zeigt jeden Endpunkt mit Beispielen. Über Authorize trägst du deinen Schlüssel ein und probierst direkt aus.

    https://…/api/v1/docs

Python

import requests

BASIS = "https://…/api/v1"
KOPF = {"Authorization": "Bearer vw_DEIN_SCHLUESSEL"}

for f in requests.get(f"{BASIS}/firmen", headers=KOPF, timeout=30).json()["firmen"]:
    print(f["domain"], f["score"], f["status"])

Gut zu wissen

  • Endpunkte: /konto, /firmen, /firmen/{domain} mit /massnahmen, /wettbewerb, /fragenleiter, /verlauf, dazu /messungen, /fragen, /maerkte, /signale, /ki-zugang.
  • Grenzen: 60 Aufrufe je Minute und 5.000 je Tag und Schlüssel. Darüber kommt HTTP 429 mit Retry-After.
  • Fehler kommen immer als {"fehler": "code", "text": "Erklärung"}.
  • Säulen ohne belastbare Daten haben messbar: false und score: null, nie 0.
  • n8n und Make: HTTP-Knoten mit der Kopfzeile Authorization: Bearer und den Adressen oben. Die OpenAPI-Beschreibung steht unter /openapi.json.

Trennen und Datenschutz

Einen Schlüssel widerrufst du in VISIWING unter Schnittstellen, API. Er gilt sofort nicht mehr.

VISIWING sieht nur, was der Assistent oder dein System abfragt, nie deinen Chatverlauf. Schlüssel und Zugänge speichern wir nur als Prüfwert.