Synup
Criar chave
v1Recursos/Reviews/getObter avaliações que mencionam um tópico

Obter avaliações que mencionam um tópico

Aprofunde-se nas avaliações que mencionam um tópico, opcionalmente restrito a um mês.

get/api/v1/reviews/topic-trends/reviews
reviews:read
Parâmetros de consulta
locationIdstringobrigatório
clientIdstringobrigatório
topicstringobrigatório
O tópico a consultar (de GET /api/v1/reviews/topic-trends).
monthstringopcional
Restringir a uma célula do mapa de calor (AAAA-MM). Omita para o histórico completo.
limitintegeropcional
Máximo de avaliações a retornar.
Resposta
dataobjectopcional
reviewsarray of objectopcional
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/reviews
Sua chave de API
locationId *
clientId *
topic *
month
limit
{
  "data": {
    "reviews": [
      {
        "id": "rev_1",
        "author": "Jane D.",
        "rating": 5,
        "body": "Everyone here is so friendly!",
        "sentiment": "positive",
        "topicSentiment": "positive",
        "platform": "google",
        "platformLabel": "Google",
        "date": "2026-02-01T12:00:00.000Z"
      }
    ]
  }
}

Guias que usam este recurso