/api/v4/locations/{locationId}/bing-analyticsOttieni i dati analitici di Bing per una sede
Restituisce le metriche settimanali delle visualizzazioni del profilo Bing Places di una sede per un intervallo di date.
Parametri
Percorso
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| locationId | string | obbligatorio | 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
| Nome | Tipo | Obbligatorio | Descrizione | Predefinito |
|---|---|---|---|---|
| fromDate | string | facoltativo | Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted. | — |
| toDate | string | facoltativo | End of the range (YYYY-MM-DD). | — |
Risposte
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.
{ "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.
Restituisce i dati sulle visualizzazioni del profilo Bing Places di una sede. I dati analitici di Bing sono raggruppati per settimana: ogni punto in views rappresenta il numero di visualizzazioni di una settimana a partire da startTime. I dati vengono aggiornati ogni lunedì per la settimana precedente, quindi vedrai i dati dell'ultima settimana completa.
Entrambe le forme di id funzionano nel percorso
bing-analytics accetta l'id Relay in Base64 (TG9jYXRpb246MTgwMDI4OQ==) o l'id numerico grezzo (1800289), ed entrambi identificano la stessa sede. Preferisci l'id Relay, che è quello restituito dagli endpoint di lettura. Se il valore non corrisponde a nessuna delle due forme, viene restituito {"data":{"bingInsights":null},"errors":[...]} con uno stato 200 anziché l'oggetto delle metriche.
curl -s 'https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/bing-analytics?fromDate=2025-01-01&toDate=2025-12-31' \ -H "Authorization: API $LISTINGSAPI_KEY"Monitorare l'andamento della visibilità su Bing
Poiché Bing fornisce un valore a settimana, questo endpoint è più adatto a tracciare una linea di tendenza che all'attribuzione su base giornaliera: recupera i dati per un intervallo di più mesi e rappresenta views su un grafico per vedere se la visibilità della scheda su Bing sta aumentando o diminuendo. Quando la sede non ha dati Bing per l'intervallo (o il suo profilo Bing non è collegato), l'endpoint restituisce comunque 200 con views come array vuoto ([]): considera questo risultato come "nessun dato" anziché un errore. Combina questi dati con i dati analitici di Google e Facebook per una dashboard completa che includa più piattaforme di pubblicazione.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/bing-analytics' \ -H "Authorization: API $LISTINGSAPI_KEY"