Ottieni le analisi delle recensioni per sito

Parametri

Percorso

Nome	Tipo	Obbligatorio	Descrizione
locationId	string	obbligatorio	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Query

Nome	Tipo	Obbligatorio	Descrizione	Predefinito
startDate	string	facoltativo	Start of the comparison period (`YYYY-MM-DD`). The `delta` fields compare this period against the previous equivalent one.	—
endDate	string	facoltativo	End of the comparison period (`YYYY-MM-DD`).	—

Risposte

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

Suddivide le prestazioni delle recensioni di una sede per fonte, così puoi vedere quale piattaforma sta determinando un cambiamento. È la controparte per sito di Ottieni le analisi delle interazioni (KPI complessivi) e Ottieni la serie temporale delle analisi delle recensioni (serie giornaliera).

Ogni voce in stats descrive una fonte di recensioni:

key / siteUrl: la chiave breve della fonte e l'URL del relativo sito. siteUrl corrisponde a siteSettings[].name di Elenca le fonti di recensioni per una sede.
averageRating, totalInteractions, newInteractions: ciascuno è un oggetto con un value per il periodo richiesto e un delta, la variazione percentuale rispetto al periodo equivalente precedente.
baseRating / baseInteractions: i valori corrispondenti all'inizio del periodo, che costituiscono la base rispetto alla quale viene misurato delta.
recency: timestamp della recensione più recente proveniente da quella fonte, null se la fonte non ne ha mai restituita una.
humanizedRecency: lo stesso istante formattato per la visualizzazione ("3 giorni fa").

Caso d'uso: individuare quale piattaforma ha modificato la media

Quando la valutazione complessiva di una sede scende, questo endpoint indica dove. Leggi averageRating.delta per ciascuna fonte: un singolo valore anomalo negativo, mentre quelli delle altre fonti rimangono stabili, indica un problema su una piattaforma, mentre un insieme di valori prevalentemente negativi indica un problema del punto vendita. Un newInteractions.value pari a 0 per una fonte il cui recency risale a mesi fa di solito significa che la connessione non si aggiorna più, piuttosto che i clienti abbiano smesso di lasciare recensioni, quindi verifica anche con Elenca le fonti di recensioni per una sede.

La risposta riportata sopra è un esempio.