v1Recursos/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/topicsCuerpo de la solicitud
clientIdstringobligatorio
The client (business) this concerns.
namestringobligatorio
The topic's name, up to 80 characters.
descriptionstringopcional
An optional note, up to 255 characters.
kindstring (brand | competitor | product | industry | campaign | custom)obligatorio
What the topic is about. A competitor topic also needs competitorId.
competitorIdstringopcional
The competitor a competitor topic follows.
queryobjectobligatorio
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 stringobligatorio
The networks to follow: x, reddit, bluesky, tiktok, instagram, facebook, youtube, news, web, reviews.
languagesarray of stringopcional
Up to five two-letter language codes. Empty means any language.
Respuesta
dataobjectopcional
topicobjectopcional
The topic that was created.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/listening/topics
Su clave de API
Cuerpo de la solicitud*
{}