v1Recursos/Social Listening/getLeer la percepción de una entidad seguida

Leer la percepción de una entidad seguida

Requiere un usuario activo de la agencia con acceso a Escucha y al cliente. Solo lee publicaciones públicas guardadas; excluye los canales propios aunque se soliciten. Las fechas son días UTC inclusivos, hasta 400 días; por defecto, siete días hasta ayer. Los filtros de lista se separan con comas. La percepción requiere entity=brand o un ID de competidor seguido; entidades desconocidas devuelven 404. El intervalo de cuota es hour, day o week (day por defecto). Sin recopilación ni generación con IA.

get/api/v1/listening/competitive/perception
listening:read
Parámetros de consulta
clientIdstringobligatorio
fromstringopcional
tostringopcional
comparebooleanopcional
segmentstring (public | owned | all)opcional
topicIdsarray of stringopcional
entitiesarray of stringopcional
themeIdsarray of stringopcional
tagIdsarray of stringopcional
sourcesarray of string (x | reddit | bluesky | tiktok | instagram | facebook | youtube | news | web | reviews)opcional
sentimentarray of string (positive | neutral | negative)opcional
languagesarray of stringopcional
messageTypesarray of stringopcional
contentTypesarray of stringopcional
includeSpambooleanopcional
unclassifiedbooleanopcional
qstringopcional
excludearray of stringopcional
entitystringobligatorio
Respuesta
dataobjectopcional
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
503No se pudieron leer los datos competitivos.
get/api/v1/listening/competitive/perception
Su clave de API
clientId *
from
to
compare
segment
topicIds
entities
themeIds
tagIds
sources
sentiment
languages
messageTypes
contentTypes
includeSpam
unclassified
q
exclude
entity *
{}

¿Nuevo en la API de Synup?