Synupv1
Schlüssel erstellen
v1Ressourcen/Profilanalysen/getProfile-Analytics-Zusammenfassung abrufen

Profile-Analytics-Zusammenfassung abrufen

Über die Standorte eines Kunden aggregierte Profile Analytics — Profilaufrufe, alle Aktionen, Website-Besuche, Anrufe, Wegbeschreibungsanfragen, Button-Klicks, Follower und Beitragsinteraktionen, plus ein Leaderboard je Standort. Mit tagId auf einen einzelnen Tag eingrenzen oder weglassen für alle Standorte des Kunden. Nutzt denselben Rollup wie die Ansicht Listings → Alle Standorte → Profile Analytics.

get/api/v1/analytics/summary
analytics:read
Query-Parameter
clientIdstringerforderlich
Der zusammenzufassende Kunde. Erforderlich.
tagIdstringoptional
Eine Standort-Tag-ID (aus GET /api/v1/locations/tags mit withId=1) — Rollup auf die Standorte dieses Tags eingrenzen. Weglassen für alle Standorte des Kunden.
fromstringoptional
Fensterbeginn (ISO-Datum). Standard: vor 30 Tagen.
tostringoptional
Fensterende (ISO-Datum). Standard: jetzt.
sourcesstringoptional
Kommagetrennte einzuschließende Publisher: google, facebook, apple, bing. Standard: alle.
comparisonstring (none | previous_period)optional
Summen mit einem vorherigen Fenster gleicher Länge vergleichen.
granularitystring (daily | weekly | monthly)optional
Zeitintervall für die zugrunde liegende Reihe.
leaderboardLimitintegeroptional
Top-N-Standorte im Leaderboard (1–100). Standard 25.
leaderboardSearchstringoptional
Leaderboard nach Standortname filtern.
Antwort
dataobjectoptional
connectedSourcesarray of string (google | facebook | apple | bing)optional
Publisher, die an mindestens einem Standort im Geltungsbereich verbunden sind.
locationsnumberoptional
Anzahl der Standorte im Geltungsbereich.
coverageobjectoptional
Wie viele der Standorte im Geltungsbereich im Zeitfenster Daten gemeldet haben.
withDatanumberoptional
Standorte, die Daten gemeldet haben.
totalnumberoptional
Standorte im Geltungsbereich.
summarystringoptional
KI-Zusammenfassung auf Kundenebene — für diesen Rollup nicht befüllt (immer null).
syncedAtstringoptional
Wann die zugrunde liegende Aggregation zuletzt lief.
latestDataDaystringoptional
Der letzte Tag mit Daten im gesamten Geltungsbereich.
profileViewsobjectoptional
Profilaufrufe, summiert über den Geltungsbereich.
metricstringoptional
Name der Kennzahl.
totalnumberoptional
Gesamtwert für den gewählten Zeitraum, oder null.
previousTotalnumberoptional
Gesamtwert für den vorherigen vergleichbaren Zeitraum, oder null.
labelsarray of stringoptional
Datumsbeschriftungen für jeden Punkt der Reihe.
bySourceobjectoptional
Tageswerte, aufgeschlüsselt nach verbundener Quelle.
allActionsobjectoptional
Alle Kundenaktionen, summiert über den Geltungsbereich.
metricstringoptional
Name der Kennzahl.
totalnumberoptional
Gesamtwert für den gewählten Zeitraum, oder null.
previousTotalnumberoptional
Gesamtwert für den vorherigen vergleichbaren Zeitraum, oder null.
labelsarray of stringoptional
Datumsbeschriftungen für jeden Punkt der Reihe.
bySourceobjectoptional
Tageswerte, aufgeschlüsselt nach verbundener Quelle.
websiteVisitsobjectoptional
Website-Besuche, summiert über den Geltungsbereich.
metricstringoptional
Name der Kennzahl.
totalnumberoptional
Gesamtwert für den gewählten Zeitraum, oder null.
previousTotalnumberoptional
Gesamtwert für den vorherigen vergleichbaren Zeitraum, oder null.
labelsarray of stringoptional
Datumsbeschriftungen für jeden Punkt der Reihe.
bySourceobjectoptional
Tageswerte, aufgeschlüsselt nach verbundener Quelle.
phoneCallsobjectoptional
Anrufe, summiert über den Geltungsbereich.
metricstringoptional
Name der Kennzahl.
totalnumberoptional
Gesamtwert für den gewählten Zeitraum, oder null.
previousTotalnumberoptional
Gesamtwert für den vorherigen vergleichbaren Zeitraum, oder null.
labelsarray of stringoptional
Datumsbeschriftungen für jeden Punkt der Reihe.
bySourceobjectoptional
Tageswerte, aufgeschlüsselt nach verbundener Quelle.
directionRequestsobjectoptional
Wegbeschreibungsanfragen, summiert über den Geltungsbereich.
metricstringoptional
Name der Kennzahl.
totalnumberoptional
Gesamtwert für den gewählten Zeitraum, oder null.
previousTotalnumberoptional
Gesamtwert für den vorherigen vergleichbaren Zeitraum, oder null.
labelsarray of stringoptional
Datumsbeschriftungen für jeden Punkt der Reihe.
bySourceobjectoptional
Tageswerte, aufgeschlüsselt nach verbundener Quelle.
buttonClicksobjectoptional
Button-Klicks, summiert über den Geltungsbereich.
metricstringoptional
Name der Kennzahl.
totalnumberoptional
Gesamtwert für den gewählten Zeitraum, oder null.
previousTotalnumberoptional
Gesamtwert für den vorherigen vergleichbaren Zeitraum, oder null.
labelsarray of stringoptional
Datumsbeschriftungen für jeden Punkt der Reihe.
bySourceobjectoptional
Tageswerte, aufgeschlüsselt nach verbundener Quelle.
followersobjectoptional
Follower-KPI-Reihe, summiert über den Geltungsbereich.
metricstringoptional
Name der Kennzahl.
totalnumberoptional
Gesamtwert für den gewählten Zeitraum, oder null.
previousTotalnumberoptional
Gesamtwert für den vorherigen vergleichbaren Zeitraum, oder null.
labelsarray of stringoptional
Datumsbeschriftungen für jeden Punkt der Reihe.
bySourceobjectoptional
Tageswerte, aufgeschlüsselt nach verbundener Quelle.
postEngagementobjectoptional
Beitragsinteraktionen, summiert über den Geltungsbereich.
metricstringoptional
Name der Kennzahl.
totalnumberoptional
Gesamtwert für den gewählten Zeitraum, oder null.
previousTotalnumberoptional
Gesamtwert für den vorherigen vergleichbaren Zeitraum, oder null.
labelsarray of stringoptional
Datumsbeschriftungen für jeden Punkt der Reihe.
bySourceobjectoptional
Tageswerte, aufgeschlüsselt nach verbundener Quelle.
searchKeywordsarray of objectoptional
Für diesen Rollup immer leer — Keyword-Daten je Standort finden sich unter GET /api/v1/analytics.
keywordstringoptional
impressionsnumberoptional
keywordMonthsobjectoptional
Für diesen Rollup immer null.
fromstringoptional
tostringoptional
followersTotalobjectoptional
Facebook-Follower-Anzeige, Stand Fensterende.
totalnumberoptional
Aktuelle Follower-Zahl.
previousTotalnumberoptional
Follower-Zahl am Ende des vorherigen Fensters (wenn ein Vergleich angefordert wird).
locationsnumberoptional
Zur Anzeige beitragende Standorte.
leaderboardobjectoptional
Ranking je Standort nach Profilaufrufen.
rowsarray of objectoptional
Eine Zeile je Standort, nach Profilaufrufen sortiert.
locationIdstringoptional
Standort-ID.
namestringoptional
Standortname.
citystringoptional
Standort-Stadt.
profileViewsnumberoptional
Profilaufrufe für diesen Standort.
allActionsnumberoptional
Alle Aktionen für diesen Standort.
phoneCallsnumberoptional
Anrufe für diesen Standort.
directionRequestsnumberoptional
Wegbeschreibungsanfragen für diesen Standort.
deltaPctnumberoptional
Änderung gegenüber dem vorherigen Fenster, bei Profilaufrufen.
sparkarray of numberoptional
Profilaufrufe je Zeitraum über das Fenster, für ein Sparkline-Diagramm.
totalnumberoptional
Gesamtzahl passender Standorte (für Pagination).
pagenumberoptional
Aktuelle Leaderboard-Seite (0-basiert).
pageSizenumberoptional
Leaderboard-Seitengröße.
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/analytics/summary
Ihr API-Schlüssel
clientId *
tagId
from
to
sources
comparison
granularity
leaderboardLimit
leaderboardSearch
{
  "data": {
    "connectedSources": [
      "google",
      "facebook"
    ],
    "summary": null,
    "syncedAt": "2026-02-01T00:00:00.000Z",
    "latestDataDay": "2026-01-31",
    "profileViews": {
      "metric": "Profile Views",
      "total": 4800,
      "previousTotal": 4300,
      "labels": [
        "2026-01-01",
        "2026-01-31"
      ],
      "bySource": {
        "google": [
          160,
          168
        ]
      }
    },
    "allActions": {
      "metric": "All Actions",
      "total": 1100,
      "previousTotal": 980,
      "labels": [],
      "bySource": {}
    },
    "websiteVisits": {
      "metric": "Website Visits",
      "total": 600,
      "previousTotal": 540,
      "labels": [],
      "bySource": {}
    },
    "phoneCalls": {
      "metric": "Phone Calls",
      "total": 210,
      "previousTotal": 195,
      "labels": [],
      "bySource": {}
    },
    "directionRequests": {
      "metric": "Direction Requests",
      "total": 340,
      "previousTotal": 300,
      "labels": [],
      "bySource": {}
    },
    "buttonClicks": {
      "metric": "Button Clicks",
      "total": 80,
      "previousTotal": 70,
      "labels": [],
      "bySource": {}
    },
    "followers": {
      "metric": "Followers",
      "total": null,
      "previousTotal": null,
      "labels": [],
      "bySource": {}
    },
    "postEngagement": {
      "metric": "Post Engagement",
      "total": null,
      "previousTotal": null,
      "labels": [],
      "bySource": {}
    },
    "searchKeywords": [],
    "keywordMonths": null,
    "impressionSplit": {
      "maps": 0,
      "search": 0,
      "desktop": 0,
      "mobile": 0
    },
    "followersTotal": {
      "total": 812,
      "previousTotal": 790,
      "locations": 4
    },
    "coverage": {
      "withData": 4,
      "total": 5
    },
    "locations": 5,
    "leaderboard": {
      "rows": [
        {
          "locationId": "cl_a1b2c3",
          "synupLocationId": "os_9f8e7d6c",
          "name": "Acme Dental — Downtown",
          "city": "Austin",
          "profileViews": 1900,
          "allActions": 420,
          "phoneCalls": 90,
          "directionRequests": 140,
          "deltaPct": 0.12,
          "spark": [
            58,
            61,
            64,
            60,
            66
          ]
        }
      ],
      "total": 5,
      "page": 0,
      "pageSize": 25
    }
  }
}