Synup
Criar chave
v1Recursos/Reviews/getObter tendências de tópicos

Obter tendências de tópicos

Uma série temporal agrupada por tópico de avaliação, um ranking, movimentos ascendentes/descendentes, e tópicos emergentes/em declínio — para um local.

get/api/v1/reviews/topic-trends
reviews:read
Parâmetros de consulta
locationIdstringobrigatório
clientIdstringobrigatório
windowDaysinteger (30 | 90 | 180)opcional
Janela de tendência em dias: 30, 90 ou 180. Padrão 90.
Resposta
dataobjectopcional
O payload completo de Tendências de Tópicos.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/reviews/topic-trends
Sua chave de API
locationId *
clientId *
windowDays
{
  "data": {
    "window": 90,
    "total": 210,
    "tagged": 180,
    "topics": [
      {
        "topic": "friendly staff",
        "origin": "auto",
        "mentions": 42,
        "positive": 38,
        "neutral": 3,
        "negative": 1,
        "avgRating": 4.8,
        "monthly": [
          {
            "count": 14,
            "positive": 12,
            "neutral": 1,
            "negative": 1
          },
          {
            "count": 28,
            "positive": 26,
            "neutral": 2,
            "negative": 0
          }
        ],
        "deltaMentions": 14,
        "deltaNetSentiment": 0.08
      }
    ],
    "rising": [
      {
        "topic": "friendly staff",
        "deltaMentions": 14,
        "thisMentions": 42,
        "netSentiment": 0.92,
        "deltaNetSentiment": 0.08
      }
    ],
    "declining": [
      {
        "topic": "wait time",
        "deltaMentions": -5,
        "thisMentions": 12,
        "netSentiment": -0.4,
        "deltaNetSentiment": -0.15
      }
    ],
    "emerging": [
      "online booking"
    ],
    "faded": [],
    "narrative": "Mentions of friendly staff are up sharply this month."
  }
}

Guias que usam este endpoint