v1Ressourcen/Social Listening/patchUpdate a listening competitor
Update a listening competitor
Edits a competitor's name, aliases, handles or website, or accepts a suggested one with status active.
patch
listening:write/api/v1/listening/competitors/{id}Query-Parameter
idstringerforderlich
The competitor's id.
Anfragetext
clientIdstringerforderlich
The client (business) this concerns.
namestringoptional
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.
statusstring (active | suggested)optional
Set active to accept a suggested competitor.
Antwort
dataobjectoptional
competitorobjectoptional
The competitor after the change.
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.
patch/api/v1/listening/competitors/{id}
Ihr API-Schlüssel
id *
Anfragetext*
{}