list_bulk_audit_competitors renvoie les concurrents candidats d'une campagne d'audit GEO en masse, extraits des résultats du scan mutualisé et classés par nombre de résultats qui les ont mentionnés, plus les noms déjà figés comme sélection.

Quand l'utiliser

Quand une campagne atteint CURATING, ce tool montre quelles marques les LLMs ont fait remonter sur tout le segment. Une seule curation couvre la campagne entière et se projette sur chaque rapport de cible : c'est l'unique étape de review pour un lot de N audits. Passez les noms retenus à select_bulk_audit_competitors.

Input

Champ	Type	Défaut	Description
`bulkAuditId`	string (CUID)	-	L'id de campagne renvoyé par `list_bulk_audits`. Retourne `bulk_audit_not_found` s'il n'appartient pas à votre workspace.
`limit`	entier (1-200)	50	Nombre max de candidats par page, triés par nombre de mentions décroissant.
`cursor`	string	-	Curseur opaque issu du `pageInfo.nextCursor` de la page précédente.

Response

{
  "success": true,
  "bulkAuditId": "clx_bulk_42",
  "status": "CURATING",
  "curatable": true,
  "selectedCompetitors": [],
  "suggestedCompetitors": [
    { "name": "Acme", "count": 37 },
    { "name": "Globex", "count": 12 }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "50", "totalCount": 806 }
}

Notes sur les champs :

count est le nombre de résultats de scan qui ont mentionné la marque. Une entité n'est comptée qu'une fois par résultat : une marque citée trois fois dans une même réponse ne pèse pas plus qu'une marque qui apparaît dans trois réponses différentes.
curatable vaut true seulement quand status est CURATING, le seul status où une sélection peut être soumise.
selectedCompetitors reflète ce qui est déjà figé sur la campagne (vide tant que la curation n'a pas été soumise).

Introuvable

{ "success": false, "error": "bulk_audit_not_found", "message": "No bulk campaign with this id exists in your workspace. Verify the bulkAuditId returned by list_bulk_audits." }

Tips et patterns

Branchez sur curatable. S'il vaut false, n'appelez pas select_bulk_audit_competitors : la campagne n'attend pas de sélection.
La première page suffit presque toujours. Les candidats sont pré-triés par count ; les pages suivantes sont la longue traîne à une mention.
Les cibles peuvent apparaître en candidats. Les cibles d'une campagne remontent parfois comme entités dans le scan mutualisé. Les garder ou non est votre décision.

Tools liés

select_bulk_audit_competitors : figer la sélection et passer la campagne en GENERATING.
get_bulk_audit : poller le status de la campagne.
list_geo_audit_competitors : l'équivalent pour un audit simple.