get_bulk_audit

get_bulk_audit récupère une campagne d'audit GEO en masse par son id : où elle en est dans son cycle de vie, combien de cibles se trouvent dans chaque status, et, une fois COMPLETED, les recommandations et idées de contenu de segment mutualisées sur tous les rapports.

Quand l'utiliser

Pour poller une campagne que vous avez déclenchée, savoir si elle vous attend (CURATING), et lire les insights de segment une fois terminée. C'est l'équivalent bulk de get_geo_audit.

Input

Response

En cours

{
  "success": true,
  "bulkAuditId": "clx_bulk_42",
  "status": "CURATING",
  "segmentTopic": "Plombiers à Lyon",
  "label": "Plombiers à Lyon",
  "targetCount": 12,
  "targetsByStatus": { "SCANNING": 12 },
  "progress": { "received": 120, "expected": 120 },
  "createdAt": "2026-09-14T09:12:00.000Z",
  "isComplete": false,
  "message": "Scans done. The campaign is paused at competitor curation — call select_bulk_audit_competitors before insights can be generated."
}

Terminée

{
  "success": true,
  "bulkAuditId": "clx_bulk_42",
  "status": "COMPLETED",
  "targetCount": 12,
  "targetsByStatus": { "COMPLETED": 12 },
  "isComplete": true,
  "country": "FR",
  "language": "fr",
  "llms": ["CHATGPT", "PERPLEXITY"],
  "occurrences": 1,
  "creditsCost": 420,
  "personas": [{ "id": "p1", "name": "Propriétaire" }],
  "selectedCompetitors": ["Acme", "Globex"],
  "recommendations": [{ "category": "content", "severity": "important", "title": "Publier des pages villes" }],
  "contentIdeas": [{ "title": "Comment choisir un plombier à Lyon", "angle": "guide d'achat" }],
  "insightsGeneratedAt": "2026-09-15T08:40:00.000Z",
  "completedAt": "2026-09-15T08:41:00.000Z",
  "message": "Per-target metrics and report URLs: list_geo_audits({ filters: { bulkAuditId } }), then get_geo_audit on any target."
}

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." }

Notes sur les champs :

• Les cibles ne sont pas renvoyées ici. Une campagne peut en contenir des centaines : la liste est paginée par list_geo_audits({ filters: { bulkAuditId } }). À la place vous avez targetCount et targetsByStatus, le compte de cibles par status.
• country et language sont stockés sur les cibles, pas sur le parent : ils sont lus sur la première cible de la campagne.
• recommendations et contentIdeas sont au niveau segment : générés une fois à la fin de la campagne et réutilisés par le rapport partagé de chaque cible.

Tips et patterns

• Branchez sur status, pas seulement sur isComplete. CURATING veut dire que la campagne attend select_bulk_audit_competitors ; le champ message donne l'étape suivante pour chaque status en cours.
• Servez-vous de targetsByStatus comme barre de progression plutôt que de paginer toutes les cibles juste pour les compter.
• Puis descendez d'un cran. list_geo_audits({ filters: { bulkAuditId, status: ["COMPLETED"] } }) donne les cibles terminées avec leur reportUrl ; get_geo_audit donne les metrics d'une cible.

Tools liés

• list_bulk_audits : trouver l'id de campagne.
• list_geo_audits : paginer les cibles de la campagne.
• select_bulk_audit_competitors : débloquer une campagne coincée en CURATING.