Synupv1
Schlüssel erstellen
v1Ressourcen/Veröffentlichte Einträge

Veröffentlichte Einträge

Den Listing-Synchronisierungsstatus eines Standorts über Verzeichnisse hinweg lesen.

Liefert den Synchronisierungsstatus über Publisher hinweg, den Google-Unternehmensprofil-Status und Verbesserungsvorschläge für einen Standort.

Eintrag eines Standorts abrufen

get/api/v1/listings
listings:read
Query-Parameter
locationIdstringerforderlich
Der abzurufende Standort. Erforderlich. 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.
Antwort
dataobjectoptional
statsobjectoptional
Zusammenfassende Zahlen über alle Publisher dieses Standorts.
publishersnumberoptional
Gesamtzahl der erfassten Publisher.
syncednumberoptional
Anzahl der aktuell synchronisierten Publisher.
notConnectednumberoptional
Anzahl der noch nicht verbundenen Publisher.
googleVerifiedLocationsnumberoptional
Anzahl der Google-verifizierten Standorte.
duplicatesnumberoptional
Anzahl der erkannten doppelten Listings.
connectionIssuesnumberoptional
Anzahl der Publisher mit einem Verbindungsproblem.
requiresActionnumberoptional
Anzahl der Publisher, die eine Aktion erfordern.
publishersarray of objectoptional
Synchronisierungsstatus je Publisher.
publisherIdstringoptional
Kennung des Verzeichnisses/Publishers.
publisherNamestringoptional
Anzeigename des Publishers.
statusstring (synced | in_progress | failed | requires_action | not_connected | expired | suspended | pending_approval | inaccessible | credentials_invalidated | not_available)optional
Einer von: synced, in_progress, failed, requires_action, not_connected, expired, suspended, pending_approval, inaccessible, credentials_invalidated, not_available.
liveLinksnumberoptional
Anzahl der für diesen Publisher gefundenen Live-Links, oder null.
gbpobjectoptional
Zusammenfassung des Google-Unternehmensprofils, sofern verbunden.
connectedbooleanoptional
Ob ein Google-Unternehmensprofil verbunden ist.
scorenumberoptional
Vollständigkeitswert des Profils, 0–100, oder null.
donearray of stringoptional
Abgeschlossene Profilverbesserungen.
todoarray of stringoptional
Ausstehende Profilverbesserungen.
opportunitiesarray of objectoptional
Vorgeschlagene Verbesserungen, jeweils mit kurzer Meldung und Ton.
textstringoptional
tonestring (amber | rose | blue | zinc)optional
aiobjectoptional
Eine kurze, KI-generierte Überschrift und bis zu 3 priorisierte Korrekturen für diesen Standort, oder null.
headlinestringoptional
Ein-Satz-Zusammenfassung des Listing-Zustands dieses Standorts.
fixFirstarray of objectoptional
Bis zu 3 vorgeschlagene nächste Schritte, nach Wirkung geordnet.
textstringoptional
impactstring (High | Med | Low)optional
noticestringoptional
Ein für Menschen lesbarer Hinweis zu den Listing-Daten dieses Standorts, oder null.
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.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/listings
Ihr API-Schlüssel
locationId *
clientId
{
  "data": {
    "stats": {
      "publishers": 42,
      "synced": 38,
      "notConnected": 2,
      "googleVerifiedLocations": 1,
      "duplicates": 0,
      "connectionIssues": 1,
      "requiresAction": 1
    },
    "publishers": [
      {
        "publisherId": "google",
        "publisherName": "Google",
        "status": "synced",
        "liveLinks": 1
      }
    ],
    "gbp": {
      "connected": true,
      "score": 82,
      "done": [
        "Business name",
        "Address"
      ],
      "todo": [
        "Add photos"
      ]
    },
    "opportunities": [
      {
        "text": "Add more photos to your Google profile",
        "tone": "amber"
      }
    ],
    "ai": {
      "headline": "90% synced — 1 listing needs action.",
      "fixFirst": [
        {
          "text": "Reconnect 1 listing needing action.",
          "impact": "High"
        }
      ]
    },
    "notice": null
  }
}
v1Ressourcen/Veröffentlichte Einträge/getListings-Zusammenfassung abrufen

Publisher-Sync-Status über die Standorte dieses Kunden (oder der gesamten Agentur) — eine Gesamtübersicht plus Aufschlüsselung je Standort, Insights (Health-%, Sync-Verteilung, schwächste Publisher, priorisierte "Handlungsbedarf"-Einträge) und eine deterministische Kurzzusammenfassung. Mit tags auf eine Teilmenge eingrenzen. Nutzt denselben Rollup wie die Ansicht Listings → Alle Standorte.

Listings-Zusammenfassung abrufen

get/api/v1/listings/summary
listings:read
Query-Parameter
clientIdstringoptional
Auf die Standorte eines Kunden beschränken.
tagsstringoptional
Kommagetrennte Standort-Tag-Namen — nur Standorte mit mindestens einem davon werden berücksichtigt.
pageintegeroptional
Seite der Zeilen je Standort (1-basiert). Standard 1.
perPageintegeroptional
Zeilen pro Seite (max. 200). Standard 50.
Antwort
dataobjectoptional
summaryobjectoptional
Aggregierte Zahlen über alle Standorte im Geltungsbereich.
locationsnumberoptional
Anzahl der Standorte im Geltungsbereich.
publishersTotalnumberoptional
Gesamtzahl der Publisher-Slots über alle Standorte im Geltungsbereich.
publishersSyncednumberoptional
Davon aktuell synchronisiert.
connectionIssuesnumberoptional
Native Connector-Zeilen (Google/Facebook) mit Verbindungsproblem.
duplicatesnumberoptional
Erkannte doppelte Einträge im Geltungsbereich.
reviewsnumberoptional
Gesamtzahl der Bewertungen im Geltungsbereich.
avgRatingnumberoptional
Durchschnittsbewertung über Standorte mit einer Bewertung.
rowsarray of objectoptional
Eine Zeile je Standort im Geltungsbereich (paginiert).
locationIdstringoptional
Standort-ID.
namestringoptional
Standortname.
citystringoptional
Standort-Stadt.
publishersnumberoptional
Publisher-Slots für diesen Standort.
syncednumberoptional
Davon aktuell synchronisiert.
connectionIssuesnumberoptional
Native Connector-Zeilen mit Verbindungsproblem.
duplicatesnumberoptional
Erkannte doppelte Einträge für diesen Standort.
reviewsnumberoptional
Gesamtzahl der Bewertungen für diesen Standort.
unrepliednumberoptional
Bewertungen ohne Antwort.
avgRatingnumberoptional
Durchschnittsbewertung für diesen Standort.
googleVerifiedbooleanoptional
Google-Eintrag ist verbunden und verifiziert.
googleConnectedbooleanoptional
Google ist verbunden (Verifizierung kann noch ausstehen).
tagsarray of stringoptional
Interne Tags dieses Standorts.
insightsobjectoptional
Aus den obigen Zeilen abgeleitete Insights.
healthnumberoptional
publishersSynced / publishersTotal, in Prozent.
distributionobjectoptional
Standorte nach Sync-Rate gruppiert (fullySynced 100 %, healthy 90–99 %, atRisk <90 %).
fullySyncednumberoptional
Standorte mit 100 % Sync.
healthynumberoptional
Standorte mit 90–99 % Sync.
atRisknumberoptional
Standorte unter 90 % Sync.
weakestarray of objectoptional
Publisher mit der geringsten Abdeckung im Geltungsbereich.
idstringoptional
Publisher-ID.
namestringoptional
Publisher-Name.
totalnumberoptional
Standorte mit diesem Publisher.
syncednumberoptional
Davon synchronisiert.
requiresActionnumberoptional
Davon mit Handlungsbedarf.
notConnectednumberoptional
Davon nicht verbunden.
pctnumberoptional
Synchronisierter Anteil, gerundet.
directoriesarray of objectoptional
Vollständige Abdeckungstabelle je Publisher.
idstringoptional
Publisher-ID.
namestringoptional
Publisher-Name.
totalnumberoptional
Standorte mit diesem Publisher.
syncednumberoptional
Davon synchronisiert.
requiresActionnumberoptional
Davon mit Handlungsbedarf.
notConnectednumberoptional
Davon nicht verbunden.
pctnumberoptional
Synchronisierter Anteil, gerundet.
attentionarray of objectoptional
Priorisierte "Handlungsbedarf"-Karten.
nnumberoptional
Anzahl, die diese Karte repräsentiert.
titlestringoptional
Kartentitel.
substringoptional
Kartenuntertitel.
tonestring (amber | blue | rose | zinc)optional
Visueller Ton dieser Karte.
filterstring (issues | duplicates | under80 | unverified | notconnected)optional
Passender Filterschlüssel der Standorttabelle.
headlinestringoptional
Eine deterministische Kurzzusammenfassung des Gesamtzustands.
fixFirstarray of objectoptional
Priorisierte Korrekturvorschläge.
textstringoptional
Beschreibung der Korrektur.
impactstring (High | Med | Low)optional
Geschätzte Wirkung dieser Korrektur.
filterstring (issues | duplicates | under80 | unverified | notconnected)optional
Passender Filterschlüssel der Standorttabelle.
totalnumberoptional
Gesamtzahl passender Standorte (für Pagination), unabhängig von perPage.
pagenumberoptional
Aktuelle Seite (1-basiert).
perPagenumberoptional
Zeilen pro Seite.
Fehler
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/listings/summary
Ihr API-Schlüssel
clientId
tags
page
perPage
{
  "data": {
    "summary": {
      "locations": 12,
      "publishersTotal": 96,
      "publishersSynced": 81,
      "connectionIssues": 3,
      "duplicates": 2,
      "reviews": 340,
      "avgRating": 4.6
    },
    "rows": [
      {
        "locationId": "loc_456",
        "name": "Acme Dental — Downtown",
        "city": "Austin",
        "publishers": 8,
        "synced": 7,
        "connectionIssues": 0,
        "duplicates": 0,
        "reviews": 26,
        "unreplied": 2,
        "avgRating": 4.8,
        "googleVerified": true,
        "googleConnected": true,
        "facebookConnected": true,
        "tags": [
          "vip"
        ]
      }
    ],
    "insights": {
      "health": 84,
      "distribution": {
        "fullySynced": 9,
        "healthy": 2,
        "atRisk": 1
      },
      "weakest": [
        {
          "locationId": "loc_789",
          "name": "Acme Dental — Eastside",
          "health": 40
        }
      ],
      "directories": [
        {
          "id": "google",
          "name": "Google Maps",
          "total": 12,
          "synced": 11,
          "requiresAction": 0,
          "notConnected": 1,
          "pct": 92
        }
      ],
      "attention": [
        {
          "n": 1,
          "title": "1 location under 90% synced",
          "sub": "Listings not fully propagated",
          "tone": "amber",
          "filter": "under80"
        }
      ],
      "headline": "84% listing health — 1 location under 90% synced needs attention.",
      "fixFirst": [
        {
          "text": "Reconnect 1 location's listing sync.",
          "impact": "Med"
        }
      ]
    },
    "total": 12,
    "page": 1,
    "perPage": 50
  }
}
v1Ressourcen/Veröffentlichte Einträge/getShare 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.

Share of Voice abrufen

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
            }
          ]
        }
      ]
    }
  }
}
v1Ressourcen/Veröffentlichte Einträge/getCitation Index abrufen

Wie viele Verzeichnisse diesen Standort indizieren, aktuell im Vergleich zu einem vorherigen Zeitraum.

Citation Index abrufen

get/api/v1/seo/citation-index
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
availablebooleanoptional
Ob für diesen Standort bereits ein Citation-Index-Snapshot existiert.
currentobjectoptional
Der letzte Snapshot am oder vor dem Fensterende.
percentagenumberoptional
Prozentsatz der aktuell indexierten Einträge (0–100), oder null.
listingsnumberoptional
Gesamtzahl der in diesem Snapshot gezählten aktiven Einträge, oder null.
indexednumberoptional
Davon die Anzahl der indexierten Einträge, oder null.
previousobjectoptional
Der letzte Snapshot am oder vor dem Fensterbeginn, zum Vergleich.
percentagenumberoptional
Prozentsatz der aktuell indexierten Einträge (0–100), oder null.
listingsnumberoptional
Gesamtzahl der in diesem Snapshot gezählten aktiven Einträge, oder null.
indexednumberoptional
Davon die Anzahl der indexierten Einträge, oder null.
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/citation-index
Ihr API-Schlüssel
locationId *
clientId
from
to
{
  "data": {
    "available": true,
    "current": {
      "percentage": 90.48,
      "listings": 42,
      "indexed": 38
    },
    "previous": {
      "percentage": 83.33,
      "listings": 42,
      "indexed": 35
    }
  }
}