Share-of-Voice snapshot completed

Webhook

POST

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

Request

Header Params

Body Params application/json

Example

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

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.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
    }
}'

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

Location deleted

Grid rank report ready