Ottieni i dati analitici di Google per una sede

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

200Daily Google interaction metrics. Each metric is a time-series array; a metric is `null` when no data exists for the range or the profile is not connected.

Response

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

401Unauthenticated, missing or invalid API key.

Restituisce i dati giornalieri delle interazioni con Google Business Profile per una sede. Ogni metrica è un array di punti di una serie temporale, in cui ogni punto contiene un startTime (il giorno a cui viene attribuito il conteggio) e un value.

Metriche disponibili:

total: impressioni totali del profilo, search più maps. Non include le metriche relative alle azioni riportate di seguito, quindi nell'esempio precedente 412 = 300 dalla ricerca + 112 dalle mappe.
search: impressioni nei risultati di Google Search (desktop e dispositivi mobili combinati)
maps: impressioni nei risultati di Google Maps (desktop e dispositivi mobili combinati)
directionsAction: richieste di indicazioni stradali per raggiungere la sede
phoneAction: clic sul pulsante di chiamata
websiteAction: clic per accedere al sito web
businessBookings: prenotazioni avviate dal profilo
businessFoodOrders: ordini di cibo effettuati dal profilo
businessFoodMenuClicks: clic sul link al menu

Entrambe le forme di id funzionano nel percorso

Sia 1800289 sia TG9jYXRpb246MTgwMDI4OQ== identificano la stessa sede. Preferisci l'id Relay in Base64: è quello restituito da ogni endpoint di lettura ed è la forma accettata dal resto dell'API. Se il valore non è né un numero né un id Relay decodificabile, viene restituito un 200 con corpo {"data":{"googleInsights":null},"errors":[...]}, che è facile scambiare per un errore del server.

Shell

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

Creare un report sull'impatto di un aggiornamento dei dati

Un utilizzo comune è un report sulla visibilità prima e dopo una modifica: dopo aver inviato modifiche agli orari o alle categorie di una sede, interroga periodicamente google-analytics per le settimane precedenti e successive alla modifica e rappresenta in un grafico search + maps per mostrare l'incremento. Le singole metriche vengono restituite come null (anziché come array vuoto) quando la sede non dispone di dati Google per l'intervallo richiesto o il suo profilo Google non è collegato; gestisci null e [] allo stesso modo nell'aggregazione. Abbina questi dati ai dati analitici di Facebook e Bing per una vista che comprenda più piattaforme di pubblicazione.