get_prompt_result

get_prompt_result renvoie le détail complet d'un ou plusieurs résultats de prompt par id : les sources citées (séparées en visibles et cachées), les appels de recherche fan-out lancés par le LLM, les mentions de concurrents et, en opt-in, la réponse brute du LLM. Il accepte jusqu'à 10 ids dans un seul appel, pour qu'une IA puisse tirer tous les LLMs d'une même date de scan d'un coup. Chaque section est activable indépendamment pour garder des payloads minimaux.

Quand l'utiliser

Appelez ce tool après que list_prompt_results vous a donné les ids qui vous intéressent. C'est la moitié "lourde" du pattern lecture-de-l'historique : c'est ici que la réponse brute et la liste complète des sources voyagent vraiment. Comme la réponse brute est le champ le plus lourd (une réponse LLM complète, souvent plusieurs Ko), elle est désactivée par défaut. Mettez include.response = true quand vous avez besoin du texte, et plafonnez-le avec maxResponseChars si vous ne voulez que le début.

Input

Champ	Type	Défaut	Description
projectId	string (CUID)	requis	Projet qui doit posséder chaque résultat (sert au contrôle d'accès).
resultId	string (CUID)	—	Un id de résultat unique. Fournir celui-ci ou resultIds.
resultIds	string[] (CUID)	—	1 à 10 ids de résultat récupérés en un appel.
include.response	boolean	false	Inclure la réponse brute du LLM. Off par défaut (champ le plus lourd).
include.sources	boolean	true	Inclure les sources citées (visibles + cachées).
include.fanOut	boolean	true	Inclure les appels fan-out (queries + sources).
include.competitors	boolean	false	Inclure les mentions de concurrents.
maxResponseChars	integer	—	Tronquer la réponse brute à ce nombre de caractères (met truncated: true).

Response

data contient un objet par résultat résolu, dans l'ordre demandé. errors liste les ids non trouvés ou n'appartenant pas au projet, sans bloquer le reste du batch. Une section n'apparaît que si son flag include est activé.

{
  "data": [
    {
      "id": "clx_res_2001",
      "promptId": "clx_prompt_07",
      "promptText": "best affordable AI visibility tracker",
      "country": "US",
      "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.",
      "response": {
        "text": "There are several affordable options...",
        "length": 4820,
        "truncated": false
      },
      "sources": {
        "visible": [
          { "url": "https://g2.com/categories/geo", "title": "GEO tools on G2", "description": null, "anchorText": "G2", "position": 1 }
        ],
        "hidden": [
          { "url": "https://reddit.com/r/SEO/x", "title": "Reddit thread", "description": null, "anchorText": null, "position": 4 }
        ]
      },
      "fanOut": [
        { "queries": ["affordable ai visibility tracker"], "sources": [{ "url": "https://g2.com/categories/geo", "title": "GEO tools on G2" }], "at": "2026-06-08T06:01:00.000Z" }
      ],
      "competitors": [
        { "name": "Otterly", "rawName": "Otterly.ai", "position": 1, "context": "cité comme un tracker populaire", "sourceUrl": "https://otterly.ai" }
      ]
    }
  ],
  "errors": []
}

Tips et patterns

• Laissez include.response off tant que vous n'avez pas besoin du texte. Servez-vous de responseLength (renvoyé par list_prompt_results) pour décider, et de maxResponseChars pour ne tirer que le début.
• Groupez les ids d'une même date de scan (un par LLM) dans un seul appel pour comparer comment chaque moteur a répondu sans N allers-retours.
• Les sources visibles sont celles citées inline dans la réponse ; les sources cachées sont celles affichées sous "More" / panneau Sources. Le découpage vous dit ce que le lecteur voit vraiment versus ce que le LLM a consulté.
• Traitez errors comme attendu, pas fatal : un id peut manquer si le résultat a été purgé ou appartient à un autre projet.

Tools liés

• list_prompt_results — l'index qui vous donne les ids à récupérer ici.
• list_scans — grouper les résultats par scan avant de tirer le détail.
• list_competitors — les totaux concurrents au niveau projet, derrière les mentions par résultat.