Concurrents
Les marques que vous suivez en plus de la vôtre. Les identifiants de concurrents renvoyés ici sont les valeurs actor_id utilisées par les endpoints de métriques.
GET/dimensions/competitors
Liste les concurrents du projet.
GET/dimensions/competitors/:id
Renvoie le détail d’un concurrent, dont ses variantes du nom et ses identifiants dans les boutiques d’applications.
GET/competitors/suggestions
L’onglet Suggestions de la page Concurrents. basis=brands (par défaut) renvoie les marques concurrentes proposées par la recherche de concurrents par IA qui ne sont pas encore suivies ni rejetées, avec les noms sous lesquels elles seraient détectées ; basis=citations renvoie les domaines les plus cités par les réponses de l’IA qui ne sont ni les vôtres ni encore suivis, avec le nombre de réponses qui citent chacun. discovery indique si une recherche est encore en cours de chargement. Lecture seule : cet endpoint ne lance jamais de recherche. Ajoutez une suggestion avec POST /competitors. Également disponible via l’outil MCP list_competitor_suggestions.
project_idobligatoirebasisbrands|citationsquerypageper_page20 par défaut, 100 maximumoutput
POST/competitors
Ajoute un concurrent avec sa propre règle de correspondance des URL citées. Respecte le nombre maximal de concurrents prévu par le forfait.
project_idobligatoirebrand_nameobligatoiredomainobligatoire, l’URL est normaliséematching_namestableau facultatifcitation_match_modedomain,hostoupath_prefix;domainpar défautcitation_match_pathobligatoire avecpath_prefix
PATCH/DELETE /competitors/:id
Met à jour un concurrent (brand_name, domaine ou hôte du site, matching_names, couleur, correspondance des URL citées) ou le supprime. Une modification du nom, du site ou de la règle de citation relance en arrière-plan la correspondance sur l’historique (processing: true pendant quelques minutes, modifications bloquées pendant ce temps). La suppression est irréversible : le concurrent disparaît immédiatement, puis une tâche en arrière-plan supprime ses mentions, ses citations, ses données de sentiment et son historique de Share of Voice. Ses publicités, produits Shopping, établissements locaux et entités de marque sont conservés et rattachés au projet ou à un autre concurrent auquel ils correspondent, ou restent non attribués.
project_idobligatoirebrand_namedomaindomaine ou hôte du site ; une URL complète est normaliséematching_namestableau de remplacement completcolorhexadécimalcitation_match_modecitation_match_path
DELETE : project_id + :id dans l’URL.