按站点获取评价分析

参数

路径

名称	类型	必填	描述
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，通常意味着连接已失效，而非客户停止发表评价，因此请通过列出地点的评价来源进行交叉核查。

上述响应为示例。