Synup
Créer une clé
v1Ressources/Reviews/getObtenir les tendances des sujets

Obtenir les tendances des sujets

Une série temporelle groupée par sujet d'avis, un classement, des mouvements ascendants/descendants, et des sujets émergents/en déclin — pour un emplacement.

get/api/v1/reviews/topic-trends
reviews:read
Paramètres de requête
locationIdstringobligatoire
clientIdstringobligatoire
windowDaysinteger (30 | 90 | 180)facultatif
Fenêtre de tendance en jours : 30, 90 ou 180. Par défaut 90.
Réponse
dataobjectfacultatif
Le contenu complet des Tendances de sujets.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/reviews/topic-trends
Votre clé 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."
  }
}

Guides qui utilisent cet endpoint