Obtener la serie temporal de análisis de reseñas

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	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	opcional	Last day of the series (`YYYY-MM-DD`).	—
site	string	opcional	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

Respuestas

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

Devuelve la serie diaria de reseñas en la que se basa un gráfico de tendencias: cuántas reseñas llegaron en cada fecha y la valoración media en estrellas de esas reseñas. Es el equivalente temporal de Obtener análisis de interacciones (indicadores clave de rendimiento generales) y Obtener análisis de reseñas por sitio (desglose por fuente).

Cada entrada contiene tres campos:

date: el día del calendario, en formato YYYY-MM-DD.
interactionCount: las reseñas recibidas ese día.
averageRating: la valoración media en estrellas de las reseñas de ese día, con el valor null en los días sin reseñas. Es la media diaria, no una media acumulada, por lo que una sola reseña de 1 estrella en un día de poca actividad se muestra como 1.0 incluso si la tienda tiene buenas valoraciones.

Caso de uso: un minigráfico de 30 días

Para dibujar una tendencia de 30 días debajo de la valoración media en estrellas de una ubicación, llama a esta ruta con startDate y endDate que abarquen ese intervalo y representa interactionCount con barras y averageRating con una línea. Combínala con la ruta de resumen para obtener las cifras principales; los campos delta del resumen ya incluyen la comparación con el período equivalente anterior, por lo que no necesitas consultar dos intervalos por tu cuenta.

Pasa site para dividir la serie por fuente, por ejemplo, para mostrar que una caída en la valoración se produjo en una plataforma y no de forma generalizada. El valor es la URL del sitio tal como aparece en siteSettings[].name de Enumerar las fuentes de reseñas de una ubicación.

La respuesta anterior es un ejemplo.