list_prompt_results

list_prompt_results renvoie l'historique d'un prompt : une ligne légère par LLM × persona × scan, triée par date. Chaque ligne porte les métadonnées du résultat (LLM, persona, marque mentionnée ou non, position de la marque, sentiment, contexte de mention) plus les compteurs de sources citées (visibles et cachées), de queries fan-out et de concurrents, ainsi que la longueur de la réponse brute. Elle ne porte volontairement jamais la réponse brute du LLM ni le corps complet des sources, pour que parcourir un long historique reste économe.

Quand l'utiliser

C'est la moitié "index" du pattern lecture-de-l'historique. Utilisez-la pour voir comment un prompt a évolué dans le temps, ou comment il a performé sur un scan donné, sans brûler de tokens sur des réponses complètes. Filtrez par promptId pour suivre un prompt, par trackingRunId pour lire un seul scan, ou par dateRange pour lire l'historique à partir d'une date. Chaque ligne expose son id. Passez cet id (ou jusqu'à 10 à la fois) à get_prompt_result pour tirer la réponse brute, les sources citées et les appels fan-out du résultat précis qui vous intéresse.

Input

Champ	Type	Défaut	Description
projectId	string (CUID)	requis	Projet ciblé (sert au contrôle d'accès).
cursor	string	—	Cursor de pagination (l'id de la dernière ligne).
limit	integer	20	1 à 100.
filters.promptId	string (CUID)	—	Restreindre à l'historique d'un prompt.
filters.llm	enum	—	Restreindre à un LLM.
filters.personaId	string (CUID)	—	Restreindre à une persona.
filters.trackingRunId	string (CUID)	—	Restreindre à un scan (voir list_scans).
filters.mentioned	boolean	—	Garder seulement les résultats mentionnés (true) ou non (false).
filters.dateRange.from	string (ISO)	—	Résultats créés à partir de ce timestamp.
filters.dateRange.to	string (ISO)	—	Résultats créés jusqu'à ce timestamp.
sortBy	enum	recent	recent (plus récent d'abord) ou oldest.

Response

data est un tableau de lignes de résultat. responseLength est le nombre de caractères de la réponse brute stockée (pour que l'IA décide si elle la récupère) ; hasResponse vaut false quand aucune réponse n'a été capturée.

{
  "data": [
    {
      "id": "clx_res_2001",
      "promptId": "clx_prompt_07",
      "date": "2026-06-08T06:01:00.000Z",
      "trackingRunId": "clx_run_88",
      "llm": "PERPLEXITY",
      "persona": { "id": "clx_persona_1", "name": "Solo founder" },
      "mentioned": true,
      "mentionCount": 2,
      "brandPosition": 3,
      "sentiment": "positive",
      "mentionContext": "Cité parmi les trackers de visibilité IA abordables.",
      "counts": { "sourcesVisible": 4, "sourcesHidden": 6, "fanOutQueries": 3, "competitors": 5 },
      "responseLength": 4820,
      "hasResponse": true
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "clx_res_2001", "totalCount": 210 },
  "summary": { "totalResults": 210 }
}

Tips et patterns

• Commencez par filters.promptId + sortBy: "oldest" pour lire la timeline d'un prompt dans l'ordre, puis ne récupérez que les résultats où mentioned a basculé.
• counts vous dit ce qu'un appel get_prompt_result renverrait avant même de le faire. Une ligne avec fanOutQueries: 0 et sourcesVisible: 0 a peu à inspecter.
• Pour comparer les moteurs sur un même scan, filtrez par trackingRunId et lisez les lignes par LLM côte à côte, puis groupez leurs id dans un seul appel get_prompt_result.
• responseLength permet d'éviter de tirer des réponses très longues (ou de les plafonner avec maxResponseChars sur le get).

Tools liés

• get_prompt_result — tirer la réponse brute, les sources et le fan-out d'une ou plusieurs lignes.
• list_scans — découvrir les IDs de scan pour filtrer par trackingRunId.
• list_llm_sources — les sources agrégées par domaine, tous prompts confondus.