v1Ressourcen/Social Listening/postAdd a listening competitor
Add a listening competitor
Adds a competitor to track. A competitor you archived earlier comes back instead of duplicating.
post
listening:write/api/v1/listening/competitorsAnfragetext
clientIdstringerforderlich
The client (business) this concerns.
namestringerforderlich
The competitor's name.
aliasesarray of stringoptional
Other names people use for it, up to 10.
handlesobjectoptional
Its accounts by network, for example { "x": ["peets"] }.
websitestringoptional
Its website.
Antwort
dataobjectoptional
competitorobjectoptional
The competitor that was added.
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.
409Die Anfrage steht im Widerspruch zum aktuellen Zustand der Ressource — zum Beispiel beim Ändern der E-Mail-Adresse oder Telefonnummer eines Empfängers, dem bereits eine Nachricht gesendet wurde, oder bei einer Team-Einladung, die bereits akzeptiert wurde (oder noch nicht akzeptiert wurde).
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/listening/competitors
Ihr API-Schlüssel
Anfragetext*
{}