Dapatkan analitik ulasan berdasarkan situs

Parameter

Path

Nama	Tipe	Wajib	Deskripsi
locationId	string	wajib	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Query

Nama	Tipe	Wajib	Deskripsi	Default
startDate	string	opsional	Start of the comparison period (`YYYY-MM-DD`). The `delta` fields compare this period against the previous equivalent one.	—
endDate	string	opsional	End of the comparison period (`YYYY-MM-DD`).	—

Respons

200One entry per review source configured for the location. Response key `interactionsSitesStats`.

Response

{  "data": {    "interactionsSitesStats": {      "stats": [        {          "key": "google",          "siteUrl": "maps.google.com",          "averageRating": { "value": 4.6, "delta": 2.2 },          "totalInteractions": { "value": 412, "delta": 6.1 },          "newInteractions": { "value": 24, "delta": 33.3 },          "recency": "2026-09-06T14:12:00Z",          "baseRating": 4.5,          "baseInteractions": 388,          "humanizedRecency": "3 days ago"        },        {          "key": "facebook",          "siteUrl": "facebook.com",          "averageRating": { "value": 4.1, "delta": -1.4 },          "totalInteractions": { "value": 57, "delta": 0 },          "newInteractions": { "value": 0, "delta": -100 },          "recency": null,          "baseRating": 4.16,          "baseInteractions": 57,          "humanizedRecency": null        }      ]    }  }}

401Unauthenticated, missing or invalid API key.

403The key is valid but not permitted to read this location (`SY90003`).

Memerinci performa ulasan suatu lokasi berdasarkan sumber, sehingga Anda dapat melihat platform mana yang mendorong perubahan. Ini adalah padanan per situs dari Dapatkan analitik interaksi (KPI keseluruhan) dan Dapatkan linimasa analitik ulasan (deret harian).

Setiap entri dalam stats menjelaskan satu sumber ulasan:

key / siteUrl: kunci singkat sumber dan URL situsnya. siteUrl cocok dengan siteSettings[].name dari Dapatkan daftar sumber ulasan untuk suatu lokasi.
averageRating, totalInteractions, newInteractions: masing-masing merupakan objek dengan value untuk periode yang diminta dan delta, yaitu persentase perubahan dibandingkan dengan periode sebelumnya yang setara.
baseRating / baseInteractions: nilai yang bersesuaian pada awal periode, yang menjadi dasar pengukuran delta.
recency: stempel waktu ulasan terbaru dari sumber tersebut, bernilai null jika sumber tersebut belum pernah mengembalikan ulasan.
humanizedRecency: waktu yang sama dalam format untuk ditampilkan ("3 hari yang lalu").

Kasus penggunaan: menemukan platform yang mengubah rata-rata

Ketika rating keseluruhan suatu lokasi turun, rute ini menunjukkan sumber penurunannya. Baca averageRating.delta per sumber: satu nilai negatif yang menyimpang sementara nilai sumber lainnya tetap menunjukkan bahwa masalahnya ada pada satu platform, sedangkan sekumpulan nilai yang secara umum negatif menunjukkan bahwa masalahnya ada pada toko. newInteractions.value sebesar 0 pada sumber yang recency-nya sudah berbulan-bulan biasanya berarti koneksi sudah tidak diperbarui, bukan pelanggan berhenti memberikan ulasan, jadi periksa silang dengan Dapatkan daftar sumber ulasan untuk suatu lokasi.

Respons di atas adalah contoh.