list_missed_citations

list_missed_citations retourne les URL du domaine du projet citées comme sources par les LLM, mais où la marque n'est pas nommée dans la réponse. Chaque ligne est un near-miss : la page rank assez pour être pull dans la réponse, mais le LLM ne crédite pas la marque. Le tool classe les pages par nombre de citations et expose les concurrents cités à la place dans les mêmes réponses, pour que l'agent puisse prioriser et comparer.

Quand l'utiliser

Quand un agent a besoin d'une file de candidats à optimiser. Combinez avec run_page_audit pour fermer le gap automatiquement :

list_missed_citations → top 3 avec hasExistingAudit=false → run_page_audit sur chacun → poll get_page_audit

Seules les URL du domaine du projet (et sous-domaines) sont retournées. Les citations tierces ne sont pas surfacées — elles ne sont pas actionnables via Page Audit.

Input

Champ	Type	Défaut	Description
projectId	string (CUID)	requis	Projet ciblé. Doit être dans les effectiveProjectIds de la clé API.
cursor	string	—	Cursor renvoyé dans pageInfo.nextCursor à la page précédente. C'est l'URL du dernier item.
limit	int	20	Items max. 1–100.
since	datetime ISO	—	Restreint aux PromptResult créés à/après cette date.
llm	enum	—	CHATGPT, CLAUDE, PERPLEXITY, GEMINI, GROK, COPILOT, GOOGLE_AI_MODE, GOOGLE_AIO. Filtre par LLM.
minOccurrences	int	1	Drop les pages citées moins de N fois après agrégation.

Response

{
  "data": [
    {
      "url": "https://example.com/features/integrations",
      "citedCount": 7,
      "llms": ["CHATGPT", "PERPLEXITY"],
      "prompts": [
        {
          "id": "clx_p1",
          "text": "Best CRM with native Slack integration",
          "count": 4,
          "llms": ["CHATGPT", "PERPLEXITY"]
        }
      ],
      "competitorsTakingOver": [
        { "name": "Acme CRM", "count": 5 },
        { "name": "Beta Suite", "count": 2 }
      ],
      "lastSeenAt": "2026-05-06T14:32:11.000Z",
      "hasExistingAudit": false,
      "latestAuditId": null
    }
  ],
  "pageInfo": {
    "hasMore": true,
    "nextCursor": "https://example.com/features/integrations",
    "totalCount": 42
  },
  "summary": { "totalPages": 42 }
}

Notes sur les champs :

• citedCount : nombre de PromptResult où l'URL est citée comme source ET la marque n'est pas mentionnée dans la réponse.
• prompts : jusqu'à 20 prompts, triés par nombre d'occurrences DESC. Chaque entrée porte count (combien de fois ce prompt a cité la page sans nommer la marque) et llms (quels LLM ont lancé ce prompt).
• competitorsTakingOver : top 3 concurrents cités dans les mêmes réponses near-miss, ordonnés par occurrences.
• hasExistingAudit / latestAuditId : laisse l'agent skip les pages déjà couvertes par un Page Audit et linker vers le plus récent.

Tips et patterns

• Tri : par défaut citedCount DESC. À égalité, l'URL est la clé secondaire — la pagination est stable.
• De-dup avec les audits existants : filtrez hasExistingAudit = false côté client avant run_page_audit pour ne pas brûler le quota/credits sur des pages déjà couvertes.
• Concurrence sur le contexte du prompt : competitorsTakingOver donne le pourquoi. Si "Acme CRM" gagne 5/7 citations sur une page intégrations, la page doit raconter l'histoire intégration de manière incontournable.
• Cadrer l'analyse : combinez since (ex. 30 derniers jours) et llm pour cibler une régression récente sur un LLM précis, pas un drift global.

Tools liés

• run_page_audit — déclencher un Page Audit sur une URL listée ici.
• list_page_audits — vérifier ce qui est déjà audité avant d'en queue.
• list_competitors — approfondir l'analyse concurrentielle sur les noms renvoyés dans competitorsTakingOver.
• list_llm_sources — surface plus large (domaines tiers inclus) ; missed_citations est la slice étroite et orientée action.