v1Ressources/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/competitorsCorps de la requête
clientIdstringobligatoire
The client (business) this concerns.
namestringobligatoire
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.
Réponse
dataobjectfacultatif
competitorobjectfacultatif
The competitor that was added.
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.
409La requête entre en conflit avec l'état actuel de la ressource — par exemple, modifier l'e-mail ou le téléphone d'un destinataire à qui un message a déjà été envoyé, ou une invitation d'équipe déjà acceptée (ou pas encore acceptée).
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/listening/competitors
Votre clé API
Corps de la requête*
{}