Synup
Crear clave
v1Recursos/Reviews/getObtener análisis de reseñas

Obtener análisis de reseñas

KPIs (con deltas período a período), una tendencia mensual (volumen, calificación, mezcla de sentimiento, tasa de respuesta), distribución de calificaciones, desglose por plataforma, horario por día de la semana, un benchmark de la agencia, temas y un resumen de IA — para una ubicación.

get/api/v1/reviews/analytics
reviews:read
Parámetros de consulta
locationIdstringobligatorio
La ubicación a consultar.
clientIdstringobligatorio
El cliente de la ubicación.
kpiDaysinteger (7 | 30 | 90)opcional
Ventana de KPI en días: 7, 30 o 90. Por defecto 30.
trendMonthsinteger (3 | 6 | 12)opcional
Duración de la tendencia en meses: 3, 6 o 12. Por defecto 6.
Respuesta
dataobjectopcional
El payload completo de Análisis de Reseñas.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/reviews/analytics
Su clave de API
locationId *
clientId *
kpiDays
trendMonths
{
  "data": {
    "total": 210,
    "kpis": {
      "totalReviews": {
        "value": 210,
        "delta": 14
      },
      "avgRating": {
        "value": 4.4,
        "delta": 0.1
      },
      "responseRate": {
        "value": 91,
        "delta": 3
      },
      "newReviews": {
        "value": 14,
        "delta": 3
      }
    },
    "spark": {
      "counts": [
        1,
        2,
        0,
        3,
        1,
        2
      ],
      "ratings": [
        4,
        5,
        0,
        4,
        5,
        4
      ],
      "response": [
        1,
        2,
        0,
        3,
        1,
        2
      ]
    },
    "trend": {
      "months": [
        "2026-01",
        "2026-02"
      ],
      "count": [
        96,
        114
      ],
      "avgRating": [
        4.3,
        4.4
      ],
      "positive": [
        78,
        92
      ],
      "neutral": [
        12,
        14
      ],
      "negative": [
        6,
        8
      ],
      "responseRate": [
        88,
        91
      ]
    },
    "distribution": [
      4,
      8,
      12,
      60,
      126
    ],
    "byPlatform": [
      {
        "platform": "google",
        "label": "Google",
        "count": 160,
        "avgRating": 4.5
      }
    ],
    "response": {
      "replied": 204,
      "unreplied": 6,
      "unrepliedNegative": 2,
      "rate": 97
    },
    "themes": [
      {
        "keyword": "friendly staff",
        "count": 42,
        "avgRating": 4.8,
        "sentiment": "positive"
      }
    ],
    "timing": [
      10,
      20,
      30,
      40,
      50,
      60,
      0
    ],
    "benchmark": {
      "rating": {
        "location": 4.4,
        "agency": 4.2
      },
      "responseRate": {
        "location": 91,
        "agency": 84
      }
    },
    "recentUnrepliedNegatives": [
      {
        "id": "rev_1",
        "author": "Jane D.",
        "rating": 2,
        "platform": "google",
        "platformLabel": "Google",
        "body": "Long wait time.",
        "date": "2026-02-01T12:00:00.000Z"
      }
    ],
    "aiSummary": "Ratings trended up this month, driven mostly by praise for staff friendliness."
  }
}

Guías que usan este endpoint