EVENTrankings.gridrank_report_ready

Grid rank report ready

Event name: rankings.gridrank_report_ready

A Grid (local-rank map) report finished generating. 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.report_id`	string	optional	Report UUID.
`data.engine`	string	optional	Grid vendor: "GEORANKER", "LOCALFALCON", or "AWS".
`data.snapshot_date`	string	optional	Completion date, YYYY-MM-DD.
`data.geo`	object	optional	Grid geometry: latitude, longitude, grid_size, grid_distance, grid_distance_unit.
`data.average_rank`	number	optional	Average rank across all grid points.
`data.top_one_share`	number	optional	Share of points ranked #1.
`data.top_two_share`	number	optional	Share of points ranked in the top two.

Example delivery

{
  "event": "rankings.gridrank_report_ready",
  "timestamp": "2026-07-15T05:02:00Z",
  "account_id": 11073,
  "location_id": "279381",
  "data": {
    "report_id": "d4f1a2b3-1111-4c22-9d33-5e6f7a8b9c0d",
    "engine": "LOCALFALCON",
    "snapshot_date": "2026-07-15",
    "geo": {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "grid_size": 7,
      "grid_distance": 1,
      "grid_distance_unit": "km"
    },
    "average_rank": 4.2,
    "top_one_share": 0.18,
    "top_two_share": 0.35
  }
}