v1Ressourcen/Social Listening/getGesprächsanteil lesen
Gesprächsanteil lesen
Erfordert einen aktiven Agenturbenutzer mit Listening- und Kundenzugriff. Liest nur gespeicherte öffentliche Beiträge; eigene Kanäle sind auch auf Anfrage ausgeschlossen. Datumsangaben sind inklusive UTC-Tage, höchstens 400 Tage; standardmäßig die sieben Tage bis gestern. Listenfilter werden durch Kommas getrennt. Wahrnehmung erfordert entity=brand oder die ID eines beobachteten Wettbewerbers; unbekannte Entitäten ergeben 404. Das Intervall für Gesprächsanteile ist hour, day oder week (Standard day). Keine Datensammlung oder KI-Generierung.
get
listening:read/api/v1/listening/competitive/share-of-voiceQuery-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
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 Wettbewerbsdaten konnten nicht gelesen werden.
get/api/v1/listening/competitive/share-of-voice
Ihr API-Schlüssel
clientId *
from
to
compare
segment
topicIds
entities
themeIds
tagIds
sources
sentiment
languages
messageTypes
contentTypes
includeSpam
unclassified
q
exclude
interval
{}