v1Recursos/Social Listening/getListar publicaciones y comentarios de escucha

Listar publicaciones y comentarios de escucha

Requiere un usuario activo de la agencia con acceso a Escucha y al cliente. Solo lee datos guardados; nunca inicia recopilación ni generación con IA. Las fechas son días UTC inclusivos (YYYY-MM-DD), hasta 400 días; por defecto se usan los siete días hasta ayer. Los parámetros de lista se separan con comas. compare=false desactiva la comparación con el período anterior. segment selecciona publicaciones públicas, canales propios o ambos (all, predeterminado). La información de marca siempre aplica el filtro de marca. Las vistas previas tienen hasta 500 caracteres; cursor es un desplazamiento no negativo y debe reutilizarse con los mismos filtros. Los hallazgos guardados conservan sus propios períodos de pruebas. Las mediciones ausentes permanecen no disponibles.

get/api/v1/listening/mentions
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
sortstring (date | engagements | impressions)opcional
cursorstringopcional
limitintegeropcional
includeUnanalyzedbooleanopcional
themeIdstringopcional
insightIdstringopcional
opportunityIdstringopcional
daystringopcional
mentionIdsarray of stringopcional
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 de escucha.
get/api/v1/listening/mentions
Su clave de API
clientId *
from
to
compare
segment
topicIds
entities
themeIds
tagIds
sources
sentiment
languages
messageTypes
contentTypes
includeSpam
unclassified
q
exclude
sort
cursor
limit
includeUnanalyzed
themeId
insightId
opportunityId
day
mentionIds
{}

¿Nuevo en la API de Synup?