Dapatkan analitik Google untuk suatu lokasi

Parameter

Path

Nama	Tipe	Wajib	Deskripsi
locationId	string	wajib	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

Nama	Tipe	Wajib	Deskripsi	Default
fromDate	string	opsional	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	opsional	End of the range (YYYY-MM-DD).	—

Respons

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.

Mengembalikan data interaksi harian Google Business Profile untuk suatu lokasi. Setiap metrik berupa array titik deret waktu, dengan setiap titik memiliki startTime (hari yang menjadi dasar pengelompokan jumlah) dan value.

Metrik yang tersedia:

total: total tayangan profil, yaitu search ditambah maps. Total ini tidak mencakup metrik tindakan di bawah, sehingga pada contoh di atas 412 = 300 penelusuran + 112 peta.
search: tayangan di hasil Google Search (gabungan desktop dan perangkat seluler)
maps: tayangan di hasil Google Maps (gabungan desktop dan perangkat seluler)
directionsAction: permintaan petunjuk arah ke lokasi
phoneAction: klik pada tombol telepon
websiteAction: klik menuju situs web
businessBookings: pemesanan yang dimulai dari profil
businessFoodOrders: pesanan makanan yang dibuat dari profil
businessFoodMenuClicks: klik pada tautan menu makanan

Kedua bentuk id dapat digunakan dalam path

Baik 1800289 maupun TG9jYXRpb246MTgwMDI4OQ== merujuk ke lokasi yang sama. Utamakan id Relay Base64: bentuk inilah yang dikembalikan oleh setiap endpoint pembacaan dan diterima oleh bagian API lainnya. Nilai yang bukan angka maupun id Relay yang dapat didekode menghasilkan respons 200 dengan isi {"data":{"googleInsights":null},"errors":[...]}, yang mudah disalahartikan sebagai gangguan 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"

Melaporkan dampak pembaruan data

Salah satu penggunaan yang umum adalah laporan visibilitas sebelum/sesudah perubahan: setelah mengirimkan perubahan jam operasional atau kategori untuk suatu lokasi, lakukan polling pada google-analytics untuk minggu-minggu sebelum dan sesudah perubahan, lalu buat grafik search + maps untuk menunjukkan peningkatannya. Metrik individual dikembalikan sebagai null (bukan array kosong) ketika lokasi tersebut tidak memiliki data Google untuk rentang waktu yang diminta atau profil Google-nya tidak terhubung; tangani null dan [] dengan cara yang sama dalam agregasi Anda. Padukan dengan analitik Facebook dan Bing untuk mendapatkan gambaran lintas platform publikasi.