list_prompts

list_prompts retourne les prompts trackés d'un projet, avec stats agrégées, visibilité par LLM et dernier résultat de scan. C'est le tool de lecture central pour analyser la visibilité : utilisez-le pour toute question du type "où suis-je mentionné ?" au niveau prompt.

Quand l'utiliser

Sortez list_prompts quand l'utilisateur demande "sur quels prompts je gagne ?", "où mon taux de mention chute ?", "qu'est-ce que ChatGPT voit sur le prompt X ?". Le tool s'associe naturellement à list_competitors (qui d'autre est mentionné sur ces prompts) et à list_fan_outs (les queries lancées en interne par les LLMs pour répondre). Filtrez par personaIds ou categoryIds pour scoper à un public cible.

Paramètres

Champ	Type	Défaut	Description
projectId	string (CUID)	requis	Projet à interroger.
cursor	string	—	Cursor de pagination.
limit	integer	20	1 à 100.
filters.isActive	boolean	—	Seulement les prompts actifs ou en pause.
filters.country	string (2 chars)	—	Code pays ISO.
filters.personaIds	string[]	—	Filtre sur les prompts trackés sous au moins une de ces personas.
filters.categoryIds	string[]	—	Filtre par une ou plusieurs catégories.
filters.textContains	string	—	Match substring case-insensitive.
sortBy	enum	recent	recent, oldest, alphabetical.

Réponse

data contient une entrée par prompt avec ses stats (totaux, taux de mention, visibilité par LLM) et un tableau latestResult.perLlm qui montre le dernier run sur chaque moteur. Un prompt peut être tracké sous plusieurs personas : personas les liste toutes, et latestResult.perLlm contient une entrée par paire LLM × persona (le champ persona vaut null pour les prompts scannés sans persona).

{
  "data": [
    {
      "id": "clxprompt001",
      "text": "best AI visibility tracker for SEO consultants",
      "country": "US",
      "isActive": true,
      "personas": [
        { "id": "clxp1", "name": "Independent SEO consultant" },
        { "id": "clxp2", "name": "In-house marketing manager" }
      ],
      "category": { "id": "clxc1", "name": "Comparisons", "color": "#3b82f6" },
      "stats": {
        "totalResults": 84,
        "mentionRate": 0.6309,
        "visibilityByLlm": {
          "CHATGPT": 0.8,
          "PERPLEXITY": 0.95,
          "GEMINI": 0.4
        }
      },
      "latestResult": {
        "perLlm": [
          {
            "llm": "CHATGPT",
            "persona": { "id": "clxp1", "name": "Independent SEO consultant" },
            "mentioned": true,
            "brandPosition": 2,
            "sentiment": "positive",
            "mentionCount": 3,
            "runDate": "2026-04-25T06:00:00.000Z"
          },
          {
            "llm": "CHATGPT",
            "persona": { "id": "clxp2", "name": "In-house marketing manager" },
            "mentioned": false,
            "brandPosition": null,
            "sentiment": null,
            "mentionCount": 0,
            "runDate": "2026-04-25T06:00:00.000Z"
          }
        ]
      },
      "createdAt": "2026-03-01T10:00:00.000Z"
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "clxprompt020", "totalCount": 47 },
  "summary": { "totalPrompts": 47 }
}

Conseils et patterns

• Triez par recent pour investiguer un changement récent de visibilité ; triez par alphabetical pour grouper les prompts par sujet dans un rapport.
• Les clés de visibilityByLlm sont limitées aux LLMs réellement trackés sur le projet. Une clé absente signifie qu'aucun run n'a encore eu lieu pour ce moteur.
• latestResult.perLlm[].brandPosition vaut null si la marque n'est pas mentionnée. Vérifiez mentioned avant d'exploiter la position.
• Combinez un filtre personaIds avec sortBy: alphabetical pour produire un rapport stable par persona.
• Pour les prompts multi-personas, groupez latestResult.perLlm par persona.id pour comparer la visibilité entre audiences : une marque peut être citée pour une persona et absente pour une autre sur le même LLM.

Tools liés

• list_fan_outs : voir les sous-queries lancées par les LLMs pour un prompt.
• list_competitors : qui d'autre est mentionné sur le même set de prompts.
• list_llm_sources : quels domaines nourrissent les LLMs qui répondent à ces prompts.