依網站取得評論分析資料

參數

路徑

名稱	類型	必填	說明
locationId	string	必填	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

查詢

名稱	類型	必填	說明	預設值
startDate	string	選填	Start of the comparison period (`YYYY-MM-DD`). The `delta` fields compare this period against the previous equivalent one.	—
endDate	string	選填	End of the comparison period (`YYYY-MM-DD`).	—

回應

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`).

依來源細分地點的評論表現，讓您看出是哪個平台造成變化。此端點是取得互動分析（整體 KPI）和取得評論分析時間軸（每日序列）的依網站細分版本。

stats 中的每個項目都描述一個評論來源：

key / siteUrl：來源的簡短鍵值及其網站 URL。siteUrl 對應至列出地點的評論來源中的 siteSettings[].name。
averageRating、totalInteractions、newInteractions：各自為一個物件，包含所要求期間的 value，以及表示相較於前一個等長期間之百分比變化的 delta。
baseRating / baseInteractions：期間開始時的對應值，delta 即以這些值為基準計算。
recency：該來源最新一則評論的時間戳記；若該來源從未傳回評論，則為 null。
humanizedRecency：將同一時間點轉換為適合顯示的形式（「3 天前」）。

使用案例：找出是哪個平台影響了平均值

當地點的整體評分下降時，此路由會指出變化來自何處。請查看各來源的 averageRating.delta：若只有一個來源出現異常的負向變化，而其他來源持平，則問題指向單一平台；若多數來源皆呈負向變化，則問題指向店家。若某個來源的 recency 已是數個月前，而其 newInteractions.value 為 0，通常表示連線已失效，而非顧客不再撰寫評論，因此請透過列出地點的評論來源交叉確認。

上述回應為範例。