list_bulk_audits

list_bulk_audits renvoie les campagnes d'audit GEO en masse de votre workspace, de la plus récente à la plus ancienne. Une campagne lance un seul scan mutualisé sur N marques cibles et produit un rapport par cible : la campagne est le parent, chaque cible est un GEO Audit ordinaire.

Quand l'utiliser

C'est la porte d'entrée de tout ce qui est au niveau campagne : trouver celle qu'un agent doit surveiller, repérer celles bloquées à la curation des concurrents, ou compter les cibles produites par un lot. Les cibles elles-mêmes ne sont pas renvoyées ici : listez-les avec list_geo_audits({ filters: { bulkAuditId } }).

Input

Les campagnes sont liées au workspace, comme les GEO Audits simples : ce tool ne prend pas de projectId et refuse les clés API restreintes à certains projets.

Response

{
  "data": [
    {
      "id": "clx_bulk_42",
      "segmentTopic": "Plombiers à Lyon",
      "label": "Plombiers à Lyon",
      "status": "CURATING",
      "targetCount": 12,
      "llms": ["CHATGPT", "PERPLEXITY"],
      "occurrences": 1,
      "creditsCost": 420,
      "progress": { "received": 120, "expected": 120 },
      "createdAt": "2026-09-14T09:12:00.000Z",
      "completedAt": null
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 1 }
}

Notes sur les champs :

• status suit le cycle de vie de la campagne : PENDING (cibles collectées, extraction des marques) → REVIEWING (cibles peu fiables à valider) → CONFIGURING (choix des LLMs, personas et prompts) → SCANNING (scan mutualisé en cours) → CURATING (en pause, curation des concurrents au niveau campagne) → GENERATING (insights de segment en cours d'écriture) → COMPLETED.
• label reprend le segmentTopic inféré, à défaut le domaine normalisé de la première cible. Vaut null sur une campagne sans cible.
• creditsCost est ce qui a été débité au déclenchement du scan mutualisé.
• progress compte les résultats de scan reçus sur attendus, pour toute la campagne.

Tips et patterns

• Pollez sur CURATING. C'est le seul moment où un agent peut agir : list_bulk_audit_competitors, puis select_bulk_audit_competitors pour débloquer la génération sur toutes les cibles d'un coup.
• Filtrez côté serveur. filters.status: ["CURATING"] coûte moins cher que parcourir toutes les campagnes pour filtrer ensuite.
• La campagne, puis les cibles. Lisez la campagne avec get_bulk_audit, puis paginez ses cibles avec list_geo_audits({ filters: { bulkAuditId } }). Cette liste accepte aussi filters.status, donc vous pouvez ne tirer que les cibles terminées.

Tools liés

• get_bulk_audit : l'état d'une campagne et le compte de cibles par status.
• list_geo_audits : les cibles de la campagne, et les audits simples.
• list_bulk_audit_competitors : les candidats à curer pendant CURATING.