v1Ressourcen/Social Listening/getVerlauf der Listening-Kennzahlen lesen

Verlauf der Listening-Kennzahlen lesen

Erfordert einen aktiven Agenturbenutzer mit Listening-Zugriff und Zugriff auf den Kunden. Liest nur gespeicherte Daten; startet weder Datensammlung noch KI-Generierung. Datumsangaben sind inklusive UTC-Tage (YYYY-MM-DD), höchstens 400 Tage; ohne Datum gelten die sieben Tage bis gestern. Listenparameter werden durch Kommas getrennt. compare=false deaktiviert den Vergleich mit dem vorherigen Zeitraum. segment wählt öffentliche Beiträge, eigene Kanäle oder beides (all, Standard). Markenerkenntnisse verwenden immer den Markenfilter. Beitragsvorschauen umfassen höchstens 500 Zeichen; cursor ist ein nicht negativer Versatz und muss mit unveränderten Filtern verwendet werden. Gespeicherte Erkenntnisse behalten ihre eigenen Belegzeiträume. Fehlende Messwerte bleiben nicht verfügbar.

get/api/v1/listening/overview/timeseries
listening:read
Query-Parameter
clientIdstringerforderlich
fromstringoptional
tostringoptional
comparebooleanoptional
segmentstring (public | owned | all)optional
topicIdsarray of stringoptional
entitiesarray of stringoptional
themeIdsarray of stringoptional
tagIdsarray of stringoptional
sourcesarray of string (x | reddit | bluesky | tiktok | instagram | facebook | youtube | news | web | reviews)optional
sentimentarray of string (positive | neutral | negative)optional
languagesarray of stringoptional
messageTypesarray of stringoptional
contentTypesarray of stringoptional
includeSpambooleanoptional
unclassifiedbooleanoptional
qstringoptional
excludearray of stringoptional
metricstring (volume | impressions | engagements | net_sentiment)optional
breakdownstring (total | source | content_type | message_type | sentiment | engagement_type | entity | theme)optional
intervalstring (hour | day | week)optional
Antwort
dataobjectoptional
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
503Die Listening-Daten konnten nicht gelesen werden.
get/api/v1/listening/overview/timeseries
Ihr API-Schlüssel
clientId *
from
to
compare
segment
topicIds
entities
themeIds
tagIds
sources
sentiment
languages
messageTypes
contentTypes
includeSpam
unclassified
q
exclude
metric
breakdown
interval
{}

Neu bei der Synup-API?