v1Recursos/Social Listening/getLer tendências das métricas de escuta

Ler tendências das métricas de escuta

Requer um usuário ativo da agência com acesso a Escuta e ao cliente. Lê apenas dados salvos; nunca inicia coleta nem geração por IA. As datas são dias UTC inclusivos (YYYY-MM-DD), até 400 dias; por padrão, usa os sete dias terminando ontem. Parâmetros de lista são separados por vírgulas. compare=false desativa a comparação com o período anterior. segment seleciona publicações públicas, canais próprios ou ambos (all, padrão). As análises da marca sempre aplicam o filtro da marca. As prévias têm até 500 caracteres; cursor é um deslocamento não negativo e deve ser reutilizado com os mesmos filtros. As descobertas salvas mantêm seus próprios períodos de evidência. Medições ausentes permanecem indisponíveis.

get/api/v1/listening/overview/timeseries
listening:read
Parâmetros de consulta
clientIdstringobrigatório
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
metricstring (volume | impressions | engagements | net_sentiment)opcional
breakdownstring (total | source | content_type | message_type | sentiment | engagement_type | entity | theme)opcional
intervalstring (hour | day | week)opcional
Resposta
dataobjectopcional
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
503Não foi possível ler os dados de escuta.
get/api/v1/listening/overview/timeseries
Sua chave de API
clientId *
from
to
compare
segment
topicIds
entities
themeIds
tagIds
sources
sentiment
languages
messageTypes
contentTypes
includeSpam
unclassified
q
exclude
metric
breakdown
interval
{}

Novo na API da Synup?