Synupv1
Schlüssel erstellen
v1Ressourcen/Profilanalysen

Profilanalysen

Die Profilleistungsanalyse eines Standorts lesen.

Liefert Kennzahlen zu Profilaufrufen/-aktionen für einen Standort über einen Zeitraum, aufgeschlüsselt je verbundener Quelle (Google, Facebook, Apple, Bing).

Profilanalysen abrufen

get/api/v1/analytics
analytics:read
Query-Parameter
locationIdstringerforderlich
Der abzurufende Standort.
clientIdstringerforderlich
Der Kunde des Standorts.
fromstringoptional
Startdatum (YYYY-MM-DD) des Zeitraums. Optional — Standard ist das übliche Zeitfenster der Quelle.
tostringoptional
Enddatum (YYYY-MM-DD) des Zeitraums. Optional.
Antwort
dataobjectoptional
connectedSourcesarray of string (google | facebook | apple | bing)optional
Welche Plattformen dieser Standort verbunden hat: google, facebook, apple, bing.
summarystringoptional
Eine kurze, für Menschen lesbare Leistungszusammenfassung, oder null.
syncedAtstringoptional
Zeitpunkt der letzten Synchronisierung dieser Daten, als ISO-8601-Zeitstempel, oder null.
latestDataDaystringoptional
Jüngster Tag mit Daten, als YYYY-MM-DD, oder null.
profileViewsobjectoptional
Profilaufrufe im Zeitverlauf.
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 (Anrufe, Wegbeschreibungen, Website-Besuche, Button-Klicks) zusammen, im Zeitverlauf.
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 im Zeitverlauf.
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 im Zeitverlauf.
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
Anfragen nach Wegbeschreibung im Zeitverlauf.
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
Sonstige Profil-Button-Klicks im Zeitverlauf.
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
Facebook-Follower im Zeitverlauf.
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
Facebook-Post-Interaktionen im Zeitverlauf.
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
Suchbegriffe, über die dieses Listing gefunden wurde, nur Google.
keywordstringoptional
Der Suchbegriff.
impressionsnumberoptional
Anzahl der Impressionen für diesen Begriff.
keywordMonthsobjectoptional
Zeitraum, den die Suchbegriffe abdecken, oder null.
fromstringoptional
tostringoptional
impressionSplitobjectoptional
Aufschlüsselung der Impressionen nach Oberfläche, nur Google, oder null.
mapsnumberoptional
Impressionen in Google Maps.
searchnumberoptional
Impressionen in der Google-Suche.
desktopnumberoptional
Impressionen auf dem Desktop.
mobilenumberoptional
Impressionen auf Mobilgeräten.
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
Ihr API-Schlüssel
locationId *
clientId *
from
to
{
  "data": {
    "connectedSources": [
      "google"
    ],
    "summary": "Profile views are up 12% this month.",
    "syncedAt": "2026-02-01T00:00:00.000Z",
    "latestDataDay": "2026-01-31",
    "profileViews": {
      "metric": "Profile Views",
      "total": 1200,
      "previousTotal": 1050,
      "labels": [
        "2026-01-01",
        "2026-01-31"
      ],
      "bySource": {
        "google": [
          40,
          42
        ]
      }
    },
    "allActions": {
      "metric": "All Actions",
      "total": 300,
      "previousTotal": 280,
      "labels": [],
      "bySource": {}
    },
    "websiteVisits": {
      "metric": "Website Visits",
      "total": 150,
      "previousTotal": 140,
      "labels": [],
      "bySource": {}
    },
    "phoneCalls": {
      "metric": "Phone Calls",
      "total": 60,
      "previousTotal": 55,
      "labels": [],
      "bySource": {}
    },
    "directionRequests": {
      "metric": "Direction Requests",
      "total": 90,
      "previousTotal": 85,
      "labels": [],
      "bySource": {}
    },
    "buttonClicks": {
      "metric": "Button Clicks",
      "total": 20,
      "previousTotal": 18,
      "labels": [],
      "bySource": {}
    },
    "followers": {
      "metric": "Followers",
      "total": null,
      "previousTotal": null,
      "labels": [],
      "bySource": {}
    },
    "postEngagement": {
      "metric": "Post Engagement",
      "total": null,
      "previousTotal": null,
      "labels": [],
      "bySource": {}
    },
    "searchKeywords": [
      {
        "keyword": "dentist near me",
        "impressions": 320
      }
    ],
    "keywordMonths": {
      "from": "2026-01-01",
      "to": "2026-01-31"
    },
    "impressionSplit": {
      "maps": 600,
      "search": 900,
      "desktop": 500,
      "mobile": 1000
    }
  }
}
v1Ressourcen/Profilanalysen/getProfile-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.

Profile-Analytics-Zusammenfassung abrufen

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