EVENTrankings.sov_snapshot_completed

Share-of-Voice snapshot completed

Event name: rankings.sov_snapshot_completed

A Share-of-Voice snapshot was stored for a keyword (one event per keyword). Scope: location-scoped. Delivered as a signed HTTP POST to your Webhooks URL.

Every delivery is signed. Verify X-Synup-Signature before processing — see Synup Webhooks.

Payload

Name	Type	Required	Description
`event`	string	optional	Dotted event name.
`timestamp`	string	optional	ISO-8601 UTC time the event was emitted.
`account_id`	integer	optional	Synup account the event belongs to.
`location_id`	string	optional	Numeric string for location-scoped events; null for brand-scoped events.
`data`	object	optional
`data.keyword_id`	string	optional	SoV keyword identifier.
`data.engine`	string	optional	Search engine (defaults to "google").
`data.snapshot_date`	string	optional	Capture date, YYYY-MM-DD.
`data.sov`	number	optional	Share-of-voice value.
`data.rank`	integer	optional	Computed rank position.

Example delivery

{
  "event": "rankings.sov_snapshot_completed",
  "timestamp": "2026-07-15T03:15:00Z",
  "account_id": 11073,
  "location_id": "279381",
  "data": {
    "keyword_id": "84213",
    "engine": "google",
    "snapshot_date": "2026-07-15",
    "sov": 62.5,
    "rank": 3
  }
}