Synupv1
Create a key
v1Resources/Listings Published/getGet Share of Voice

Get Share of Voice

Your Grid Rank share vs. named competitors, your best-performing keywords ranked by top-3 share, and a monthly avg-rank trend over the window — for one location.

get/api/v1/seo/share-of-voice
seo:read
Query parameters
locationIdstringrequired
The location to look up. Look it up with GET /api/v1/locations.
clientIdstringoptional
The location's client. Only needed to disambiguate when your key is scoped to specific clients.
fromstringoptional
Window start (ISO date). Defaults to 30 days ago.
tostringoptional
Window end (ISO date). Defaults to now.
Response
dataobjectoptional
comparisonobjectoptional
You vs. named competitors by grid top-3 share.
availablebooleanoptional
Whether this location has grid-rank data to compute Share of Voice from.
rowsarray of objectoptional
One row per business in the comparison — you and your named competitors.
namestringoptional
The business name, or your own client name for your own row.
top3Pctnumberoptional
Share of tracked keywords where this business ranks in the top 3 (0–100), or null if not enough data.
isYoubooleanoptional
True on the row for your own location. Omitted (never false) on competitor rows.
keywordsobjectoptional
This location's keywords, ranked by latest top-3 share.
availablebooleanoptional
Whether this location has grid-rank data to compute Share of Voice from.
rowsarray of objectoptional
One row per tracked keyword.
keywordstringoptional
The tracked keyword.
top3Pctnumberoptional
Share of tracked keywords where this business ranks in the top 3 (0–100), or null if not enough data.
avgRanknumberoptional
Average rank across the window, or null if not enough data.
performanceobjectoptional
Monthly average-rank trend per keyword, bounded by from/to.
availablebooleanoptional
Whether this location has grid-rank data to compute Share of Voice from.
seriesarray of objectoptional
One series per tracked keyword.
keywordstringoptional
The tracked keyword.
pointsarray of objectoptional
Monthly average-rank data points for this keyword.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/seo/share-of-voice
Your API key
locationId *
clientId
from
to
{
  "data": {
    "comparison": {
      "available": true,
      "rows": [
        {
          "name": "Acme Dental — Downtown",
          "top3Pct": 62,
          "isYou": true
        },
        {
          "name": "Bright Smiles Dental",
          "top3Pct": 74
        }
      ]
    },
    "keywords": {
      "available": true,
      "rows": [
        {
          "keyword": "dentist near me",
          "top3Pct": 62,
          "avgRank": 3.2
        }
      ]
    },
    "performance": {
      "available": true,
      "series": [
        {
          "keyword": "dentist near me",
          "points": [
            {
              "yearMonth": "2026-01",
              "avgRank": 3.6
            },
            {
              "yearMonth": "2026-02",
              "avgRank": 3.2
            }
          ]
        }
      ]
    }
  }
}