Bing-Analysedaten für einen Standort abrufen

Parameter

Pfad

Name	Typ	Erforderlich	Beschreibung
locationId	string	erforderlich	Location ID, either the Base64 Relay id (e.g. TG9jYXRpb246MTgwMDI4OQ==) or the raw numeric database id (e.g. 1800289). Both forms resolve to the same location.

Query

Name	Typ	Erforderlich	Beschreibung	Standard
fromDate	string	optional	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	optional	End of the range (YYYY-MM-DD).	—

Antworten

200Weekly Bing view metrics. `views` is a time-series array; it is empty when no data exists for the range or the Bing profile is not connected.

Response

{  "data": {    "bingInsights": {      "views": [        { "startTime": "2025-06-02T00:00:00+00:00", "value": 73 },        { "startTime": "2025-06-09T00:00:00+00:00", "value": 58 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

Gibt Daten zu Aufrufen des Bing Places-Profils für einen Standort zurück. Bing-Analysedaten werden wochenweise zusammengefasst; jeder Punkt in views stellt die Anzahl der Aufrufe für eine Woche ab startTime dar. Die Daten werden jeden Montag für die vorangegangene Woche aktualisiert, sodass Sie die letzte vollständige Woche sehen.

Beide ID-Formate funktionieren im Pfad

bing-analytics akzeptiert die Base64-Relay-ID (TG9jYXRpb246MTgwMDI4OQ==) oder die rein numerische ID (1800289), und beide verweisen auf denselben Standort. Verwenden Sie vorzugsweise die Relay-ID, da diese von den Lese-Endpunkten zurückgegeben wird. Bei einem Wert, der keinem der beiden Formate entspricht, wird {"data":{"bingInsights":null},"errors":[...]} mit dem Status 200 anstelle des Kennzahlenobjekts zurückgegeben.

Shell

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

Trends bei der Sichtbarkeit auf Bing verfolgen

Da Bing einen Wert pro Woche meldet, eignet sich dieser Endpunkt am besten für eine Trendlinie statt für eine tagesgenaue Zuordnung: Rufen Sie einen Zeitraum von mehreren Monaten ab und stellen Sie views grafisch dar, um zu sehen, ob die Sichtbarkeit des Eintrags auf Bing steigt oder sinkt. Wenn für den Standort im gewählten Zeitraum keine Bing-Daten vorliegen (oder sein Bing-Profil nicht verbunden ist), gibt der Endpunkt dennoch 200 zurück, wobei views ein leeres Array ([]) ist; behandeln Sie dies als „keine Daten“ und nicht als Fehler. Kombinieren Sie diese Daten mit Analysedaten von Google und Facebook, um ein vollständiges Dashboard für mehrere Plattformen zu erhalten.