Webhooks & export

Receive events in real time and export your scan data in the formats you need.

Coming soon — outbound webhooks are not live yet. This page documents the planned contract (events, payload, signature) so you can design your integration ahead of the release; details may change before general availability.

Webhook events

EVENTWHEN

scan.completedA scan finishes successfully.

score.changedThe score changes versus the previous scan.

orphan.detectedA new orphan page is detected.

scan.failedA scan fails (with the reason why).

Sample 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"
}

Signature verification

Every request will include the X-Graphorank-Signature header: an HMAC-SHA256 of the raw request body computed with your signing secret. Verify it before processing the event.

Export

Two export options are available today. From the graph view in the app you can save the current rendering as a PNG snapshot — handy for reports and slide decks. Via the API, GET /v1/scans/{scan_id}/graph returns the full graph as JSON — every page with its role, PageRank and link metrics plus all edges — paginated with a cursor so large sites stream cleanly. See the API reference for the endpoint details. CSV export and white-label PDF reports (Agency plan) are on the roadmap.