Analysen

Alle Profilanalyse-Endpunkte mit cURL-, Python- und Node-Beispielen: tägliche Google- und Facebook-Metriken und wöchentliche Bing-Aufrufe je Standort.

Profilanalysen zeigen, wie oft ein Standort auf der jeweiligen Plattform gesehen wurde und wie oft dort Aktionen ausgeführt wurden: Impressionen, Seitenaufrufe, Routenanfragen, Anrufe und Website-Klicks. Es gibt drei Endpunkte, einen pro Plattform, und alle drei dienen dem Lesen von Daten, sodass ein Read (Lesen)-Schlüssel ausreicht. Jede Metrik ist eine Zeitreihe aus { startTime, value }-Punkten; die API gibt keine skalaren Gesamtwerte zurück, sodass Sie die angezeigten Summen selbst berechnen.

Endpunkte im Überblick

Alle drei verwenden dieselben Parameter. fromDate und toDate sind vom Typ YYYY-MM-DD und beide optional; wenn Sie sie weglassen, wird der von der Plattform vorgegebene Zeitraum der jüngeren Vergangenheit verwendet. Der Pfad akzeptiert die Base64-Relay-ID oder die einfache Zahl. Bei einem Wert, der keinem der beiden Formate entspricht, gibt der Endpunkt 200 zurück, wobei das insights-Objekt auf null gesetzt ist und ein errors-Array enthalten ist; dies sieht wie ein nicht verbundenes Profil aus, daher sollten Sie zuerst errors prüfen.

Google-Metriken für einen Datumsbereich abrufen

GET /locations/{locationId}/google-analytics gibt data.googleInsights mit einer täglichen Zeitreihe pro Metrik zurück. total entspricht den Profilimpressionen, also search plus maps; die Aktionsmetriken sind darin nicht enthalten. Verwenden Sie diese Metrik für einen Bericht, der die Sichtbarkeit vor und nach einer Datenänderung vergleicht.

curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2026-08-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"

{  "data": {    "googleInsights": {      "total": [        { "startTime": "2026-08-01T00:00:00+00:00", "value": 412 },        { "startTime": "2026-08-02T00:00:00+00:00", "value": 388 }      ],      "search": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 300 }],      "maps": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 112 }],      "directionsAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 24 }],      "phoneAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 8 }],      "websiteAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 41 }],      "businessBookings": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 0 }],      "businessFoodOrders": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 0 }],      "businessFoodMenuClicks": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 0 }]    }  }}

startTime jedes Datenpunkts ist der Tag, dem der Zählwert zugeordnet wird. Im Beispiel beträgt total am ersten Tag 412, also 300 search plus 112 maps.

Eine Metrik ist null und kein leeres Array, wenn für den Standort im Zeitraum keine Google-Daten vorliegen oder sein Google-Profil nicht verbunden ist. Behandeln Sie null und [] beim Aggregieren gleich.

Facebook-Metriken für einen Datumsbereich abrufen

GET /locations/{locationId}/facebook-analytics hat unter data.facebookInsights dieselbe Struktur mit fünf täglichen Zeitreihen. Dafür muss die Facebook-Seite des Standorts verbunden sein. Mit ctaAction messen Sie die Nutzung einer Schaltfläche „Jetzt buchen“ oder „Jetzt anrufen“ über einen Kampagnenzeitraum.

curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/facebook-analytics?fromDate=2026-08-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"

{  "data": {    "facebookInsights": {      "views": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 120 }],      "ctaAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 5 }],      "directionsAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 3 }],      "phoneAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 2 }],      "websiteAction": [{ "startTime": "2026-08-01T00:00:00+00:00", "value": 9 }]    }  }}

Es gibt keine Metrik für „Gefällt mir“-Angaben der Seite. Jede Zeitreihe wird als null zurückgegeben, wenn für die Seite im Zeitraum keine Daten vorliegen oder sie nicht verbunden ist; prüfen Sie daher vor dem Iterieren auf null.

Bing-Aufrufe für einen Datumsbereich abrufen

GET /locations/{locationId}/bing-analytics gibt eine einzelne Datenreihe, data.bingInsights.views, zurück, die nach Wochen statt nach Tagen gruppiert ist. Jeder Datenpunkt enthält die Anzahl der Aufrufe für eine Woche, die bei startTime beginnt. Die Daten werden jeden Montag für die vorherige Woche aktualisiert, sodass die letzte vollständige Woche die aktuellste ist, die Sie sehen. Rufen Sie für eine Trendlinie einen Zeitraum von mehreren Monaten ab; die Datenreihe eignet sich nicht für die Attribution auf Tagesebene.

curl "https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/bing-analytics?fromDate=2026-06-01&toDate=2026-08-31" \-H "Authorization: API $LISTINGSAPI_KEY"

{  "data": {    "bingInsights": {      "views": [        { "startTime": "2026-06-01T00:00:00+00:00", "value": 73 },        { "startTime": "2026-06-08T00:00:00+00:00", "value": 58 }      ]    }  }}

Anders als Google und Facebook meldet Bing fehlende Daten als leeres views-Array mit 200, nicht als null. Behandeln Sie beides als „nichts anzuzeigen“ und prüfen Sie auf length == 0, wenn Sie die Kennzeichnung „keine Daten“ anzeigen möchten, da die Summe eines leeren Arrays 0 ergibt.

Fehler, die auftreten können

Die Referenzseiten nennen keine ressourcenspezifischen Fehlercodes für Analysen. Folgende Fälle können auftreten:

Die vollständige Liste finden Sie unter Fehlercodes.

Nächste Schritte

• Profilanalysen abrufen: Summieren Sie eine Datenreihe zu einer Monatssumme und vergleichen Sie zwei Zeiträume unter Verwendung der null-Prüfungen.
• Bewertungsanalysen: Bewertungsnote, Anzahl und Antwortrate für denselben Standort, mit integrierten Differenzen zwischen Zeiträumen.
• Bewertungen: die Endpunkte für Bewertungsanalysen zusammen mit den übrigen Endpunkten der Bewertungsressource.
• Referenzübersicht: Analysen. SDKs: Python-Analysen, Node-Analysen.