v1Ressources/Social Listening/getLire la perception d’une entité suivie
Lire la perception d’une entité suivie
Nécessite un utilisateur actif de l’agence disposant de l’accès à Écoute et au client. Lit uniquement les publications publiques enregistrées ; les canaux propres sont exclus même s’ils sont demandés. Les dates sont des jours UTC inclusifs, jusqu’à 400 jours ; par défaut, les sept jours se terminant hier. Les filtres de liste sont séparés par des virgules. La perception nécessite entity=brand ou un identifiant de concurrent suivi ; les entités inconnues renvoient 404. L’intervalle de part de voix est hour, day ou week (day par défaut). Aucune collecte ni génération par IA.
get
listening:read/api/v1/listening/competitive/perceptionParamè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
entitystringobligatoire
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 concurrentielles n’ont pas pu être lues.
get/api/v1/listening/competitive/perception
Votre clé API
clientId *
from
to
compare
segment
topicIds
entities
themeIds
tagIds
sources
sentiment
languages
messageTypes
contentTypes
includeSpam
unclassified
q
exclude
entity *
{}