v1Ressources/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}Paramètres de requête
idstringobligatoire
The competitor's id.
Corps de la requête
clientIdstringobligatoire
The client (business) this concerns.
namestringfacultatif
The competitor's name.
aliasesarray of stringfacultatif
Other names people use for it, up to 10.
handlesobjectfacultatif
Its accounts by network, for example { "x": ["peets"] }.
websitestringfacultatif
Its website.
statusstring (active | suggested)facultatif
Set active to accept a suggested competitor.
Réponse
dataobjectfacultatif
competitorobjectfacultatif
The competitor after the change.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
patch/api/v1/listening/competitors/{id}
Votre clé API
id *
Corps de la requête*
{}