list_scans

list_scans liste les tracking runs (scans) d'un projet, du plus récent au plus ancien. Chaque scan est une exécution du job de tracking quotidien ou trois fois par semaine, qui regroupe tous les résultats de prompt qu'il a produits. Une ligne porte le statut du scan, ses timestamps de début et de fin, les LLMs couverts, le nombre de résultats produits et le taux de mention global.

Quand l'utiliser

Utilisez list_scans quand votre IA doit raisonner au niveau scan avant de tirer la moindre réponse : "c'était quoi le dernier scan, et comment la visibilité a bougé entre deux runs ?". C'est le moyen le moins cher de découvrir les dates et les IDs de scan. Récupérez un trackingRunId ici, passez-le à list_prompt_results pour lire les réponses par prompt de ce scan, puis à get_prompt_result pour la réponse complète et les sources. Filtrez par dateRange pour construire des rapports d'une période à l'autre.

Input

Champ	Type	Défaut	Description
projectId	string (CUID)	requis	Projet ciblé.
cursor	string	—	Cursor de pagination (l'id de la dernière ligne).
limit	integer	20	1 à 100.
filters.status	enum	—	PENDING, SCANNING, ANALYZING, COMPLETED, FAILED.
filters.dateRange.from	string (ISO)	—	Scans démarrés à partir de ce timestamp.
filters.dateRange.to	string (ISO)	—	Scans démarrés jusqu'à ce timestamp.
sortBy	enum	recent	recent (plus récent d'abord) ou oldest.

Response

data est un tableau d'objets scan. mentionRate vaut mentionedCount / resultCount (0 quand le scan n'a pas encore de résultats).

{
  "data": [
    {
      "id": "clx_run_88",
      "status": "COMPLETED",
      "startedAt": "2026-06-08T06:00:00.000Z",
      "completedAt": "2026-06-08T06:04:12.000Z",
      "totalExpectedResults": 28,
      "receivedResults": 28,
      "resultCount": 28,
      "mentionedCount": 17,
      "mentionRate": 0.607,
      "llms": ["CHATGPT", "GEMINI", "PERPLEXITY"]
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "clx_run_88", "totalCount": 96 },
  "summary": { "totalScans": 96 }
}

Tips et patterns

• Deux scans récents sur le même set de prompts permettent de calculer un delta de visibilité. Prenez mentionRate de chacun, puis creusez les prompts qui ont basculé avec list_prompt_results filtré par trackingRunId.
• Un scan bloqué longtemps en SCANNING ou ANALYZING, ou un statut FAILED, explique des trous dans l'historique. Remontez-le plutôt que de traiter une donnée manquante comme une vraie chute de visibilité.
• Un resultCount inférieur à totalExpectedResults signifie que certains LLMs n'ont pas répondu sur ce run. Croisez llms pour voir quels moteurs manquent.

Tools liés

• list_prompt_results — les réponses par prompt d'un scan (filtrez par trackingRunId).
• get_prompt_result — la réponse complète et les sources d'un résultat unique.
• list_prompts — les prompts trackés avec leurs taux de mention agrégés.