Synup
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.
keywordIdstringoptional
Eine erfasste Keyword-ID aus maps.keywords, für die Top 3 auf Google Maps gelesen wird. Weglassen, um das neueste Keyword mit einem gemessenen Scan zu verwenden.
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.
mapsobjectoptional
Top 3 auf Google Maps für ein Keyword, aus einem gespeicherten Grid-Scan.
availablebooleanerforderlich
False, wenn Ihr Schlüssel diesen Standort nicht lesen darf.
keywordsarray of objecterforderlich
Die aktiven erfassten Keywords des Standorts, neueste zuerst.
idstringerforderlich
Die ID des erfassten Keywords.
keywordstringerforderlich
Das erfasste Keyword.
measuredbooleanerforderlich
True, wenn für dieses Keyword ein gespeicherter Scan mit mindestens einem gemessenen Punkt vorliegt.
selectedKeywordIdstringerforderlich
Das Keyword, auf das sich alle maps-Zahlen beziehen. Null, wenn der Standort keine Keywords erfasst.
selectionstring (requested | default)erforderlich
requested: Sie haben das Keyword mit keywordId angegeben. default: das neueste Keyword mit einem gemessenen Scan, sonst das neueste Keyword.
reportobjecterforderlich
Der neueste Scan des ausgewählten Keywords mit einem gemessenen Punkt. Null bedeutet, dass kein gemessener Scan vorliegt, niemals 0 %.
idstringerforderlich
Die ID des gespeicherten Berichts.
keywordIdstringerforderlich
Die ID des erfassten Keywords.
keywordstringerforderlich
Das erfasste Keyword.
yearMonthstringerforderlich
Der Monat dieses Datenpunkts, als "YYYY-MM".
gridSizeintegererforderlich
Die konfigurierte Seitenlänge des Grids zum Zeitpunkt des Scans. points enthält die tatsächlichen Punkte.
completedAtstringerforderlich
Wann die vollständige Grid-Erfassung hinter genau diesen Ergebnissen abgeschlossen wurde. Null, sofern das nicht nachgewiesen ist.
generatedAtstringerforderlich
Das erfasste Datum des Berichts, gesetzt bei seinem ersten Abschluss. Weder ein Erfassungszeitpunkt noch ein Zeitpunkt der letzten Aktualisierung oder eine Live-Prüfung.
evidencestring (proven | unverified)erforderlich
proven: jeder gezählte Punkt passt zum aktuellen Keyword und Grid. unverified: ein älterer Scan, dessen Keyword und Grid nicht bestätigt werden können.
pointsarray of objecterforderlich
Jeder gespeicherte Grid-Punkt, nach Zeile und Spalte geordnet, mit seinem Status.
missingPointsintegererforderlich
Grid-Punkte ohne jegliches gespeichertes Ergebnis.
withheldPointsintegererforderlich
Gespeicherte Punkte aus einer früheren Keyword- oder Grid-Einstellung. Als withheld angezeigt und nicht gezählt.
countedintegererforderlich
Gespeicherte Punkte, die dieser Standort zählt, ohne water- und excluded-Punkte.
measuredintegererforderlich
Gezählte Punkte mit einem gemessenen Ergebnis (ranked oder outside). Der Nenner für top3.
noDataintegererforderlich
Gezählte Punkte, deren Prüfung fehlgeschlagen ist. Kein Ranking.
top3integererforderlich
Gemessene Punkte, an denen Sie unter den Top 3 lagen.
outsideintegererforderlich
Gemessene Punkte, an denen Sie nicht unter den erfassten Top 20 lagen.
top3Pctnumbererforderlich
Anteil der erfassten Keywords, bei denen dieses Unternehmen unter den Top 3 rangiert (0–100), oder null bei unzureichenden Daten.
avgRanknumbererforderlich
Durchschnittlicher Rang über die gemessenen Punkte, wobei outside als 21 zählt. Null, wenn nichts gemessen wurde.
bestRankintegererforderlich
Beste gemessene Position, 1 bis 20. Null, wenn jeder gemessene Punkt outside ist.
businessPointobjecterforderlich
Der erfasste Punkt, der den Koordinaten des Standorts am nächsten liegt. Ein Suchpunkt, nicht die Adresse selbst. Null, wenn der Standort keine Koordinaten hat.
newerUnmeasuredobjecterforderlich
Ein neuerer Scan für das Keyword, der nichts Zählbares gemessen hat, wird neben report ausgewiesen statt an dessen Stelle. Null, wenn es keinen gibt.
yearMonthstringerforderlich
Der Monat dieses Datenpunkts, als "YYYY-MM".
generatedAtstringerforderlich
Das erfasste Datum des Berichts, gesetzt bei seinem ersten Abschluss. Weder ein Erfassungszeitpunkt noch ein Zeitpunkt der letzten Aktualisierung oder eine Live-Prüfung.
competitorsarray of objecterforderlich
Sie und die stärksten Wettbewerber, gezählt über die gemessenen Punkte des Berichts. Leer ohne Bericht.
idstringerforderlich
Eine stabile ID für das Unternehmen: id: gefolgt von seiner Google-Place-ID, sonst Name plus Adresse. "you" in Ihrer eigenen Zeile.
namestringerforderlich
Der Unternehmensname wie erfasst. Kann leer sein und ist in Ihrer eigenen Zeile leer.
addressstringerforderlich
Die Adresse wie erfasst, sofern der Scan eine aufgenommen hat. Unterscheidet gleichnamige Filialen.
isYoubooleanerforderlich
True in der Zeile für Ihren eigenen Standort. Bei Mitbewerber-Zeilen weggelassen (nie false).
top3Spotsintegererforderlich
Gemessene Punkte, an denen dieses Unternehmen unter den Top 3 lag. Unternehmen teilen sich Punkte, daher ergeben die Zeilen zusammen nicht die Gesamtzahl.
scanInProgressbooleanerforderlich
True, solange ein Grid-Scan für diesen Standort läuft. Gilt für den ganzen Standort: Es sagt nicht, welche Keywords der Scan abdeckt.
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
keywordId
{
  "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
            }
          ]
        }
      ]
    }
  }
}

Anleitungen, die diesen Endpunkt verwenden