v1Ressourcen/Social Listening/getErkenntnisübersicht lesen

Erkenntnisübersicht 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/insights/briefing
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
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/insights/briefing
Ihr API-Schlüssel
clientId *
from
to
compare
segment
topicIds
entities
themeIds
tagIds
sources
sentiment
languages
messageTypes
contentTypes
includeSpam
unclassified
q
exclude
{}

Neu bei der Synup-API?