Synupv1
Schlüssel erstellen
v1Ressourcen/Veröffentlichte Einträge/getShare of Voice abrufen

Share of Voice abrufen

Ihr Grid-Rank-Anteil im Vergleich zu benannten Wettbewerbern, Ihre leistungsstärksten Keywords nach aktuellem Top-3-Anteil sortiert, und ein monatlicher Durchschnittsrang-Trend über das Zeitfenster — für einen Standort.

get/api/v1/seo/share-of-voice
seo:read
Query-Parameter
locationIdstringerforderlich
Der abzufragende Standort. Nachschlagen mit GET /api/v1/locations.
clientIdstringoptional
Der Kunde des Standorts. Nur zur Eindeutigkeit nötig, wenn Ihr Schlüssel auf bestimmte Kunden beschränkt ist.
fromstringoptional
Fensterbeginn (ISO-Datum). Standard: vor 30 Tagen.
tostringoptional
Fensterende (ISO-Datum). Standard: jetzt.
Antwort
dataobjectoptional
comparisonobjectoptional
Sie im Vergleich zu benannten Wettbewerbern nach Grid-Top-3-Anteil.
availablebooleanoptional
Ob für diesen Standort Grid-Rank-Daten zur Berechnung des Share of Voice vorliegen.
rowsarray of objectoptional
Eine Zeile pro Unternehmen im Vergleich — Sie und Ihre benannten Mitbewerber.
namestringoptional
Der Unternehmensname oder Ihr eigener Kundenname für Ihre eigene Zeile.
top3Pctnumberoptional
Anteil der erfassten Keywords, bei denen dieses Unternehmen unter den Top 3 rangiert (0–100), oder null bei unzureichenden Daten.
isYoubooleanoptional
True in der Zeile für Ihren eigenen Standort. Bei Mitbewerber-Zeilen weggelassen (nie false).
keywordsobjectoptional
Die Keywords dieses Standorts, nach aktuellem Top-3-Anteil sortiert.
availablebooleanoptional
Ob für diesen Standort Grid-Rank-Daten zur Berechnung des Share of Voice vorliegen.
rowsarray of objectoptional
Eine Zeile pro erfasstem Keyword.
keywordstringoptional
Das erfasste Keyword.
top3Pctnumberoptional
Anteil der erfassten Keywords, bei denen dieses Unternehmen unter den Top 3 rangiert (0–100), oder null bei unzureichenden Daten.
avgRanknumberoptional
Durchschnittsrang über den Zeitraum, oder null bei unzureichenden Daten.
performanceobjectoptional
Monatlicher Durchschnittsrang-Trend je Keyword, begrenzt durch from/to.
availablebooleanoptional
Ob für diesen Standort Grid-Rank-Daten zur Berechnung des Share of Voice vorliegen.
seriesarray of objectoptional
Eine Reihe pro erfasstem Keyword.
keywordstringoptional
Das erfasste Keyword.
pointsarray of objectoptional
Monatliche Durchschnittsrang-Datenpunkte für dieses Keyword.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/seo/share-of-voice
Ihr API-Schlüssel
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
            }
          ]
        }
      ]
    }
  }
}