Obtenir les statistiques des avis par site

Paramètres

Chemin

Nom	Type	Obligatoire	Description
locationId	string	obligatoire	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Chaîne de requête

Nom	Type	Obligatoire	Description	Par défaut
startDate	string	facultatif	Start of the comparison period (`YYYY-MM-DD`). The `delta` fields compare this period against the previous equivalent one.	—
endDate	string	facultatif	End of the comparison period (`YYYY-MM-DD`).	—

Réponses

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

Ventile les performances des avis d'un établissement par source, afin que vous puissiez voir quelle plateforme est à l'origine d'un changement. Il s'agit de l'équivalent par site de Obtenir les statistiques des interactions (indicateurs clés de performance globaux) et de Obtenir l'évolution chronologique des statistiques des avis (séries quotidiennes).

Chaque entrée de stats décrit une source d'avis :

key / siteUrl : la clé courte de la source et l'URL de son site. siteUrl correspond à siteSettings[].name dans Lister les sources d'avis d'un établissement.
averageRating, totalInteractions, newInteractions : chacun est un objet contenant value pour la période demandée et delta, la variation en pourcentage par rapport à la période équivalente précédente.
baseRating / baseInteractions : les valeurs correspondantes au début de la période, qui servent de référence pour mesurer delta.
recency : l'horodatage de l'avis le plus récent provenant de cette source, ou null si la source n'en a jamais renvoyé.
humanizedRecency : le même instant sous une forme destinée à l'affichage (« il y a 3 jours »).

Cas d'utilisation : déterminer quelle plateforme a fait évoluer la moyenne

Lorsque la note globale d'un établissement baisse, cette route indique où la baisse se produit. Consultez averageRating.delta pour chaque source : une seule valeur négative atypique, alors que celles des autres sources restent stables, pointe vers une plateforme, tandis que des valeurs globalement négatives pointent vers le magasin. Une valeur de 0 pour newInteractions.value sur une source dont recency date de plusieurs mois signifie généralement que la connexion n'est plus à jour plutôt que les clients ont cessé de laisser des avis ; recoupez donc ces informations avec Lister les sources d'avis d'un établissement.

La réponse ci-dessus est un exemple.