Webhooks y exportación

Recibe eventos en tiempo real y exporta los datos de tus análisis en los formatos que necesites.

Próximamente : los webhooks salientes aún no están activos. Esta página documenta el contrato previsto (eventos, payload, firma) para que puedas diseñar tu integración antes del lanzamiento; los detalles pueden cambiar antes de la disponibilidad general.

Eventos de webhook

EVENTOCUÁNDO

scan.completedUn análisis termina correctamente.

score.changedLa puntuación cambia respecto al análisis anterior.

orphan.detectedSe detecta una nueva página huérfana.

scan.failedUn análisis falla (con el motivo).

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

Verificación de la firma

Cada petición incluirá la cabecera X-Graphorank-Signature : un HMAC-SHA256 del cuerpo sin procesar de la petición, calculado con tu signing secret. Verifícala antes de procesar el evento.

Exportación

Hoy hay dos opciones de exportación. Desde la vista del grafo en la app puedes guardar el renderizado actual como una instantánea PNG , útil para informes y presentaciones. Mediante la API, GET /v1/scans/{scan_id}/graph devuelve el grafo completo como JSON : cada página con su rol, su PageRank y sus métricas de enlaces, más todas las aristas, paginado con un cursor para que los sitios grandes se transmitan sin problemas. Consulta la Referencia de la API para los detalles del endpoint. La exportación a CSV y los informes PDF de marca blanca (plan Agency) están en la hoja de ruta.

CONTINUAR

Referencia de la API →

CONTINUAR

Estado del servicio →