Obtenir la chronologie des statistiques d’avis

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	First day of the series (`YYYY-MM-DD`). Omitting it lets the service pick its default window, so pass it whenever the chart's range matters.	—
endDate	string	facultatif	Last day of the series (`YYYY-MM-DD`).	—
site	string	facultatif	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

Réponses

200One entry per day in the requested range. Response key `interactionsChartData`.

Response

{  "data": {    "interactionsChartData": {      "data": [        { "date": "2026-08-01", "interactionCount": 4, "averageRating": 4.5 },        { "date": "2026-08-02", "interactionCount": 0, "averageRating": null },        { "date": "2026-08-03", "interactionCount": 7, "averageRating": 4.285714285714286 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

403The key is valid but not permitted to read this location (`SY90003`).

Renvoie la série quotidienne d’avis sur laquelle repose un graphique de tendance : le nombre d’avis reçus à chaque date et la note moyenne en étoiles de ces avis. Il s’agit du volet chronologique qui complète Obtenir les statistiques d’interactions (indicateurs clés de performance globaux) et Obtenir les statistiques d’avis par site (répartition par source).

Chaque entrée contient trois champs :

date : le jour calendaire, au format YYYY-MM-DD.
interactionCount : les avis reçus ce jour-là.
averageRating : la note moyenne en étoiles des avis de ce jour, ou null pour un jour sans avis. Il s’agit de la moyenne quotidienne, et non d’une moyenne cumulée : un seul avis à 1 étoile reçu lors d’une journée peu active s’affiche donc sous la forme 1.0, même pour un établissement bien noté.

Cas d’utilisation : un mini-graphique sur 30 jours

Pour tracer une tendance sur 30 jours sous la note moyenne en étoiles d’un établissement, appelez cette route avec startDate et endDate couvrant cette période, puis représentez interactionCount par des barres et averageRating par une courbe. Associez-la à la route de synthèse pour obtenir les chiffres clés ; les champs delta de la synthèse fournissent déjà une comparaison avec la période précédente de même durée, vous n’avez donc pas besoin de récupérer vous-même les données de deux périodes.

Passez site pour répartir la série par source, par exemple afin de montrer qu’une baisse de la note provient d’une seule plateforme plutôt que de l’ensemble des plateformes. La valeur correspond à l’URL du site telle qu’elle apparaît dans siteSettings[].name, renvoyé par Lister les sources d’avis d’un établissement.

La réponse ci-dessus est un exemple.