Obtener analíticas de reseñas por sitio

Parámetros

Ruta

Nombre	Tipo	Obligatorio	Descripción
locationId	string	obligatorio	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Consulta

Nombre	Tipo	Obligatorio	Descripción	Predeterminado
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`).	—

Respuestas

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

Desglosa el rendimiento de las reseñas de una ubicación por fuente, para que puedas ver qué plataforma está provocando un cambio. Es el equivalente por sitio de Obtener analíticas de interacciones (KPI generales) y Obtener la serie temporal de analíticas de reseñas (serie diaria).

Cada entrada de stats describe una fuente de reseñas:

key / siteUrl: la clave corta de la fuente y la URL de su sitio. siteUrl coincide con siteSettings[].name de Listar las fuentes de reseñas de una ubicación.
averageRating, totalInteractions, newInteractions: cada uno es un objeto con un value para el período solicitado y un delta, el cambio porcentual respecto al período equivalente anterior.
baseRating / baseInteractions: los valores correspondientes al inicio del período, que se toman como referencia para medir delta.
recency: marca de tiempo de la reseña más reciente de esa fuente; null cuando la fuente nunca ha devuelto ninguna.
humanizedRecency: el mismo instante con un formato para su visualización («hace 3 días»).

Caso de uso: identificar qué plataforma hizo variar la media

Cuando baja la valoración general de una ubicación, esta ruta indica dónde. Consulta averageRating.delta por fuente: un único valor atípico negativo junto a valores estables en las demás fuentes apunta a una plataforma, mientras que un conjunto de valores mayoritariamente negativos apunta al establecimiento. Un newInteractions.value de 0 en una fuente cuyo recency tiene varios meses de antigüedad suele significar que la conexión ha dejado de actualizarse, más que que los clientes hayan dejado de publicar reseñas, así que contrasta esta información con Listar las fuentes de reseñas de una ubicación.

La respuesta anterior es un ejemplo.