SEO Intelligence

Subscribe to monthly search analyses. Webhooks only, no public REST API yet.

SEO Intelligence reads a tenant's Google Search Console data once a month, works out what changed, and produces a ranked list of recommendations. It is driven entirely from the dashboard: there is no public REST API and no embed widget for this service, so nothing for it appears in the API Reference. What it does expose is webhooks, so your own systems can react when an analysis lands.

Events

Event	When it fires
`seo.analysis.completed`	A monthly analysis finished and its findings are ready to read.
`seo.analysis.failed`	A monthly analysis could not be completed.
`seo.connection.reconnect_required`	A Google connection stopped working and needs reauthorising.
`seo.task.started`	A background job started, such as importing history.
`seo.task.completed`	A background job finished.
`seo.task.failed`	A background job could not be completed.
`seo.task.cancelled`	A background job was cancelled.

Analysis completed

json

{
  "run_id": "67edb428-f0b9-4327-bb33-d1dc701bda2f",
  "site_id": "1ccbcc0f-8720-4d84-8053-18b198d0da36",
  "period_start": "2026-07-01",
  "finding_count": 17,
  "recommendation_count": 17
}

Analysis failed

json

{
  "run_id": "67edb428-f0b9-4327-bb33-d1dc701bda2f",
  "site_id": "1ccbcc0f-8720-4d84-8053-18b198d0da36",
  "period_start": "2026-07-01",
  "error": "gsc_not_connected"
}

The error field carries a stable code, never a raw message, so you can branch on it safely.

Registering an endpoint

Webhook endpoints are registered per tenant from the dashboard, and every delivery is signed. Verification, retries and the rotation window work the same way for every service, so follow Webhooks for the signature check before you trust a payload.

Reading the results

A completed event tells you an analysis exists, not what it said. Today the findings and recommendations are read in the dashboard, or published to the tenant's Knowledge Hub as a written report. A read API for findings is not available yet.