Webhooks & Export

Empfangen Sie Events in Echtzeit und exportieren Sie Ihre Scan-Daten in den Formaten, die Sie brauchen.

Demnächst verfügbar – ausgehende Webhooks sind noch nicht live. Diese Seite dokumentiert den geplanten Vertrag (Events, Payload, Signatur), damit Sie Ihre Integration schon vor dem Release entwerfen können; Details können sich bis zur allgemeinen Verfügbarkeit ändern.

Webhook-Events

EVENTWANN

scan.completedEin Scan wird erfolgreich abgeschlossen.

score.changedDer Score ändert sich gegenüber dem vorherigen Scan.

orphan.detectedEine neue verwaiste Seite wird erkannt.

scan.failedEin Scan schlägt fehl (mit Angabe des Grundes).

Beispiel-Payload

JSON

{
  "event": "score.changed",
  "site": "rovere-arredamenti.com",
  "scan_id": "scn_12",
  "score": 68,
  "previous": 64,
  "delta": 4,
  "at": "2026-07-03T09:43:00Z"
}

Signaturprüfung

Jede Anfrage enthält den Header X-Graphorank-Signature – eine HMAC-SHA256-Signatur des rohen Request-Bodys, berechnet mit Ihrem Signing Secret. Prüfen Sie sie, bevor Sie das Event verarbeiten.

Export

Heute stehen zwei Exportoptionen zur Verfügung. In der Graph-Ansicht der App speichern Sie die aktuelle Darstellung als PNG Snapshot – praktisch für Reports und Präsentationen. Per API liefert GET /v1/scans/{scan_id}/graph den vollständigen Graph als JSON zurück: jede Seite mit Rolle, PageRank und Link-Metriken plus alle Kanten, per Cursor paginiert, sodass auch große Websites sauber gestreamt werden. Siehe die API-Referenz für die Endpunkt-Details. CSV-Export und White-Label-PDF-Reports (Agency-Tarif) stehen auf der Roadmap.