Obter análises de avaliações por site

Parâmetros

Caminho

Nome	Tipo	Obrigatório	Descrição
locationId	string	obrigatório	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Query

Nome	Tipo	Obrigatório	Descrição	Padrão
startDate	string	opcional	Start of the comparison period (`YYYY-MM-DD`). The `delta` fields compare this period against the previous equivalent one.	—
endDate	string	opcional	End of the comparison period (`YYYY-MM-DD`).	—

Respostas

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

Divide o desempenho das avaliações de um local por origem, para que você possa ver qual plataforma está causando uma mudança. É a versão por site de Obter análises de interações (KPIs gerais) e Obter a linha do tempo das análises de avaliações (série diária).

Cada entrada em stats descreve uma origem de avaliações:

key / siteUrl: a chave curta da origem e a URL do seu site. siteUrl corresponde a siteSettings[].name de Listar origens de avaliações de um local.
averageRating, totalInteractions, newInteractions: cada um é um objeto com um value para o período solicitado e um delta, a variação percentual em relação ao período equivalente anterior.
baseRating / baseInteractions: os valores correspondentes no início do período, que servem de base para medir delta.
recency: data e hora da avaliação mais recente dessa origem, ou null quando a origem nunca retornou uma avaliação.
humanizedRecency: o mesmo instante formatado para exibição ("há 3 dias").

Caso de uso: descobrir qual plataforma alterou a média

Quando a nota geral de um local cai, esta rota indica onde. Leia averageRating.delta por origem: um único resultado negativo discrepante, enquanto os demais permanecem estáveis, aponta para uma plataforma, enquanto um conjunto de resultados predominantemente negativos aponta para a loja. Um newInteractions.value de 0 em uma origem cujo recency é de meses atrás geralmente significa que a conexão deixou de se atualizar, e não que os clientes pararam de enviar avaliações, então confira também Listar origens de avaliações de um local.

A resposta acima é um exemplo.