Webhooks e exportação

Receba eventos em tempo real e exporte os dados das suas análises nos formatos de que precisa.

Em breve — os webhooks de saída ainda não estão ativos. Esta página documenta o contrato previsto (eventos, payload, assinatura) para que possa preparar a sua integração antes do lançamento; os detalhes podem mudar antes da disponibilidade geral.

Eventos de webhook

EVENTOQUANDO

scan.completedUma análise termina com sucesso.

score.changedA pontuação muda face à análise anterior.

orphan.detectedÉ detetada uma nova página órfã.

scan.failedUma análise falha (com o motivo).

Exemplo de 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"
}

Verificação da assinatura

Cada pedido incluirá o cabeçalho X-Graphorank-Signature : um HMAC-SHA256 do corpo bruto do pedido, calculado com o seu segredo de assinatura. Verifique-o antes de processar o evento.

Exportação

Hoje estão disponíveis duas opções de exportação. Na vista do grafo, na aplicação, pode guardar a representação atual como PNG — útil para relatórios e apresentações. Através da API, GET /v1/scans/{scan_id}/graph devolve o grafo completo em JSON — cada página com a sua função, PageRank e métricas de ligações, mais todas as arestas — paginado com cursor para que os sites grandes sejam transmitidos sem problemas. Consulte a referência da API para os detalhes do endpoint. A exportação em CSV e os relatórios PDF em marca branca (plano Agency) estão no roteiro.