list_geo_audits

list_geo_audits retourne les GEO Audits (audits one-shot white-label) du workspace, du plus récent au plus ancien. Chaque ligne porte le status, l'URL prospect auditée, le nom de marque, le pays et la langue ciblés, les LLMs sélectionnés et un compteur de progression. Contrairement aux correctifs de page, les GEO Audits sont liés au workspace, pas à un projet précis, donc ce tool ne prend pas de projectId.

Quand l'utiliser

• Pour les agences qui produisent beaucoup d'audits via le MCP : lister tout le workspace et lire l'état de chaque audit sans ouvrir l'UI.
• Pour repérer les audits bloqués à la sélection des concurrents (filtre filters.status: ["REVIEWING"]) avant qu'ils ne puissent passer à la génération des insights.
• Pour regrouper un lot : filters.bulkAuditId renvoie les cibles d'une campagne, filters.scope inclut (ou isole) les cibles de toutes les campagnes, filters.dateRange les audits lancés sur une fenêtre donnée.
• Pour suivre lesquels sont passés à COMPLETED et sont prêts à lire avec get_geo_audit.

Ce tool ne liste que les GEO Audits one-shot. Il ne retourne pas les correctifs de page, qui appartiennent à un projet : lisez-en un avec get_page_fix.

Input

Sans filters.bulkAuditId, le tool ne renvoie que les audits simples, comme la liste affichée dans l'app : les enfants d'une campagne ne s'y mélangent jamais. Élargissez avec filters.scope. filters.status s'applique dans tous les cas : scope: "bulk_children" avec status: ["COMPLETED"] renvoie toutes les cibles de campagne terminées du workspace.

Response

{
  "data": [
    {
      "id": "clx_audit_42",
      "prospectUrl": "https://prospect.com",
      "domain": "prospect.com",
      "brandName": "Prospect",
      "status": "REVIEWING",
      "country": "US",
      "language": "en",
      "llms": ["CHATGPT", "PERPLEXITY"],
      "creditsCost": 24,
      "shareSlug": "prospect-9f3a",
      "reportUrl": "https://mentionable.ai/share/audit/prospect-9f3a",
      "bulkAuditId": null,
      "bulkLabel": null,
      "progress": { "received": 6, "expected": 24 },
      "createdAt": "2026-06-20T09:00:00.000Z",
      "completedAt": null
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 1 }
}

Notes :

• domain est l'hôte du prospect sans protocole, sans www., sans slash final. C'est la clé de jointure avec une base de prospects externe, plus besoin de nettoyer prospectUrl à chaque import.
• reportUrl est absolu : le domaine du workspace en marque blanche, mentionable.ai sinon. À préférer à une URL reconstruite depuis shareSlug.
• bulkAuditId et bulkLabel sont remplis sur les cibles d'une campagne (bulkLabel = le thème de segment déduit de la campagne), null sur les audits simples.
• status suit le cycle de vie du GEO Audit : PENDING (créé, scan pas démarré), SCANNING (scans LLM en cours), REVIEWING (scans finis, en pause sur la sélection des concurrents), GENERATING (concurrents choisis, insights en cours d'écriture), COMPLETED (figé, rapport prêt).
• progress.received / progress.expected comptent les résultats de scan. Ils permettent d'estimer à quel point un audit SCANNING est proche de REVIEWING.
• completedAt est null tant que l'audit n'a pas atteint COMPLETED.

Tips et patterns

• Pagination : le cursor est l'id de l'audit. Stable entre pages.
• À combiner avec get_geo_audit : ce tool renvoie de la metadata uniquement. Pour lire les recommandations, les idées de contenu et les concurrents sélectionnés, appelez get_geo_audit avec l'id.
• Regrouper sans deviner : filters.bulkAuditId remplace le regroupement d'un lot par fenêtre de createdAt. Sur des audits simples lancés un par un, filters.dateRange fait le même travail.
• Balayer tous les rapports d'un coup : filters.scope: "all" avec un filtre de status est le seul appel qui couvre à la fois les audits simples et les cibles de campagne, par exemple pour récupérer toutes les URL de rapport COMPLETED du workspace.
• Surveiller REVIEWING : un audit en REVIEWING attend qu'un humain (ou un agent) confirme les concurrents. Remontez-les pour qu'ils ne stagnent pas en silence.

Tools liés

• get_geo_audit : récupérer un GEO Audit (contenu complet quand COMPLETED).
• get_page_fix : le correctif d'une page d'un projet suivi, un objet différent.