Synup
Créer une clé
v1Ressources/Social Listening/getLister les termes de conversation

Lister les termes de conversation

Nécessite un utilisateur actif de l’agence disposant de l’accès à Écoute et au client. Lit uniquement les données enregistrées ; ne lance jamais de collecte ni de génération par IA. Les dates sont des jours UTC inclusifs (YYYY-MM-DD), jusqu’à 400 jours ; par défaut, les sept jours se terminant hier. Les paramètres de liste sont séparés par des virgules. compare=false désactive la comparaison avec la période précédente. segment sélectionne les publications publiques, les canaux propres ou les deux (all par défaut). Les analyses de marque appliquent toujours le filtre de marque. Les aperçus sont limités à 500 caractères ; cursor est un décalage positif ou nul à réutiliser avec les mêmes filtres. Les observations enregistrées conservent leurs propres périodes de preuve. Les mesures manquantes restent indisponibles.

get/api/v1/listening/conversation/terms
listening:read
Paramètres de requête
clientIdstringobligatoire
fromstringfacultatif
tostringfacultatif
comparebooleanfacultatif
segmentstring (public | owned | all)facultatif
topicIdsarray of stringfacultatif
entitiesarray of stringfacultatif
themeIdsarray of stringfacultatif
tagIdsarray of stringfacultatif
sourcesarray of string (x | reddit | bluesky | tiktok | instagram | facebook | youtube | news | web | reviews)facultatif
sentimentarray of string (positive | neutral | negative)facultatif
languagesarray of stringfacultatif
messageTypesarray of stringfacultatif
contentTypesarray of stringfacultatif
includeSpambooleanfacultatif
unclassifiedbooleanfacultatif
qstringfacultatif
excludearray of stringfacultatif
typestring (keyword | hashtag | mention | emoji | entity)facultatif
rankBystring (volume | engagements)facultatif
categorystring (person | place | organization | product | event | media)facultatif
Réponse
dataobjectfacultatif
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.
503Les données d’écoute n’ont pas pu être lues.
get/api/v1/listening/conversation/terms
Votre clé API
clientId *
from
to
compare
segment
topicIds
entities
themeIds
tagIds
sources
sentiment
languages
messageTypes
contentTypes
includeSpam
unclassified
q
exclude
type
rankBy
category
{}

Vous débutez avec l'API Synup ?