Synupv1
Schlüssel erstellen
v1Ressourcen/Veröffentlichte Einträge/getListings-Zusammenfassung abrufen

Listings-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.

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