Grid rank report ready

Webhook

POST

rankings.gridrank_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.

Request

Header Params

Body Params application/json

Example

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'X-Synup-Signature: sha256=Base64Signature==' \
--header 'Content-Type: application/json' \
--data '{
    "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
    }
}'

Responses

🟢200

application/json

Your endpoint acknowledges receipt with any 2xx. A non-2xx response or a timeout (>10s) is treated as a failed delivery.

Bodyapplication/json

Example

{}

Modified at 2026-07-15 18:04:40

Share-of-Voice snapshot completed

Daily review analytics snapshot