get_fan_out_extraction

get_fan_out_extraction renvoie une extraction de fan-outs lancée avec create_fan_out_extraction ou depuis l'app. Il donne le statut, la progression prompt par prompt, une synthèse pensée pour décider, et, pour chaque prompt, les recherches lancées par le moteur de recherche de ChatGPT dans l'ordre, avec leurs requêtes et leurs résultats classés.

Chaque résultat porte des indicateurs : cited (la page appuie la réponse), opened (le moteur a ouvert la page), isOwn (votre site) et isCompetitor (un concurrent confirmé). Site et concurrent sont calculés à la lecture : un concurrent confirmé après l'extraction apparaît bien.

Quand l'utiliser

• En polling après create_fan_out_extraction, jusqu'à ce que status vaille COMPLETED, PARTIAL ou FAILED.
• Pour planifier du contenu : summary.queriesWithoutOwn liste les requêtes des prompts où votre site n'apparaît dans aucun résultat.
• Pour lire la concurrence : summary.topDomains classe les domaines que le moteur retrouve le plus, avec leur nombre de citations.

Input

Réponse

{
  "success": true,
  "extraction": {
    "id": "clx_ext_42",
    "status": "COMPLETED",
    "llm": "CHATGPT",
    "model": "gpt-5.4-mini",
    "origin": "mcp",
    "promptCount": 2,
    "creditsCharged": 5,
    "progress": { "pending": 0, "done": 1, "empty": 1, "failed": 0 },
    "createdAt": "2026-09-26T10:00:00.000Z",
    "completedAt": "2026-09-26T10:00:41.000Z"
  },
  "summary": {
    "searchedPrompts": 1,
    "ownPresence": 0,
    "competitorPresence": 1,
    "topDomains": [
      { "domain": "g2.com", "results": 2, "cited": 1, "prompts": 1, "isOwn": false, "isCompetitor": false }
    ],
    "queriesWithoutOwn": [
      { "query": "best crm for startups 2026", "promptId": "clx_p_1", "promptText": "best CRM for startups" }
    ]
  },
  "items": [
    {
      "id": "clx_i_1",
      "promptId": "clx_p_1",
      "promptText": "best CRM for startups",
      "status": "DONE",
      "country": "US",
      "searches": [
        {
          "position": 1,
          "queries": ["best crm for startups 2026"],
          "results": [
            { "url": "https://g2.com/categories/crm", "domain": "g2.com", "rank": 1, "cited": true },
            { "url": "https://hubspot.com/crm", "domain": "hubspot.com", "rank": 2, "isCompetitor": true }
          ]
        }
      ]
    }
  ]
}

Le status d'un item vaut PENDING, DONE (le moteur a cherché, 5 crédits débités), EMPTY (répondu sans recherche, rien débité) ou FAILED (rien débité). ownPresence et competitorPresence sont des parts entre 0 et 1 des prompts où le moteur a cherché. Les indicateurs et champs optionnels n'apparaissent que s'ils sont renseignés, pour garder la réponse légère. Les pages ouvertes ou citées sans apparaître dans une recherche sont listées sous otherSources.

Un id inconnu, ou une extraction d'un autre projet, renvoie { "success": false, "error": "extraction_not_found" }.

Tips et patterns

• La synthèse d'abord. Commencez avec include.items: false ; ne récupérez les items que pour les prompts que vous creusez.
• Pollez tranquillement. Tant que PENDING ou RUNNING, les items se remplissent au fil des prompts ; la forme reste la même.
• Lisez rank par recherche. Les rangs repartent à 1 à chaque recherche ; une page trouvée par deux recherches garde sa première position.
• Les requêtes viennent du moteur de recherche d'OpenAI, interrogé via son API, pas de la réponse suivie.

Tools liés

• create_fan_out_extraction : lancer une extraction.
• list_fan_out_extractions : trouver les ids d'extraction.
• list_llm_sources : les domaines cités ou recherchés par le suivi quotidien.