v1Ressourcen/Social Listening/postCreate a listening topic
Create a listening topic
Creates a topic as a suggestion. It collects nothing until you turn it on with a PATCH that sets status to active.
post
listening:write/api/v1/listening/topicsAnfragetext
clientIdstringerforderlich
The client (business) this concerns.
namestringerforderlich
The topic's name, up to 80 characters.
descriptionstringoptional
An optional note, up to 255 characters.
kindstring (brand | competitor | product | industry | campaign | custom)erforderlich
What the topic is about. A competitor topic also needs competitorId.
competitorIdstringoptional
The competitor a competitor topic follows.
queryobjecterforderlich
What to find. include is a list of alternatives (OR); each alternative is a list of term groups (AND), and a term group is { match: "all" | "any", terms: [...] }. Optional exclude lists terms that rule a post out, and fromHandles names accounts to watch by network.
sourcesarray of stringerforderlich
The networks to follow: x, reddit, bluesky, tiktok, instagram, facebook, youtube, news, web, reviews.
languagesarray of stringoptional
Up to five two-letter language codes. Empty means any language.
Antwort
dataobjectoptional
topicobjectoptional
The topic that was created.
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.
post/api/v1/listening/topics
Ihr API-Schlüssel
Anfragetext*
{}