Synup
Créer une clé
v1Ressources/Reviews/getObtenir une série mensuelle plus longue d'un sujet

Obtenir une série mensuelle plus longue d'un sujet

Nécessite reviews:read et l’accès à clientId. Fournir locationId pour un lieu ou l’omettre pour la série mensuelle du client. tag limite uniquement le bilan client et ne se combine pas avec locationId. months vaut 12 par défaut ; les bilans clients acceptent 1–24 mois. Utilise les avis enregistrés.

get/api/v1/reviews/topic-trends/series
reviews:read
Paramètres de requête
locationIdstringfacultatif
clientIdstringobligatoire
monthsintegerfacultatif
Durée de la série en mois. Par défaut 12.
tagstringfacultatif
Réponse
dataobjectfacultatif
Le contenu complet de la série mensuelle 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/series
Votre clé API
locationId
clientId *
months
tag
{
  "data": {
    "months": [
      "2026-01",
      "2026-02"
    ],
    "topics": [
      {
        "topic": "friendly staff",
        "origin": "auto",
        "total": 70,
        "monthly": [
          {
            "count": 28,
            "positive": 25,
            "neutral": 2,
            "negative": 1
          },
          {
            "count": 42,
            "positive": 38,
            "neutral": 3,
            "negative": 1
          }
        ]
      }
    ]
  }
}

Guides qui utilisent cette ressource