{
  "slug": "prompt-citation-count",
  "name": "Citations per prompt",
  "aliases": [
    "Prompt citations",
    "Total citations for a prompt"
  ],
  "definition": "How many citations one answer-engine prompt produced in the period, split into the citations your domain earned and the total across every cited domain.",
  "category": "AI visibility",
  "type": "raw measure",
  "unit": "citations",
  "direction": "higher-better",
  "verification": "verified",
  "calculation": "Two reads of the same rank dataset that differ only by the client filter, one restricted to your domain, one unrestricted, each summed per prompt in the verb and then joined on the prompt key. The client total is the restricted sum; the prompt total is the unrestricted sum, falling back to the client total when the unrestricted leg returns nothing for that prompt.",
  "aggregation": "Additive within a prompt across domains and URLs. The prompt tab orders by mentions, not by this total, so the busiest-citation prompt is not necessarily the first row.",
  "grain": "One prompt for one tracked segment over one date range, with a domain breakdown beneath it.",
  "dimensions": [
    "prompt",
    "competitor domain",
    "cited URL",
    "answer engine",
    "intent",
    "branded vs non-branded"
  ],
  "requiredFilters": [
    "tracker or tracked segment id",
    "date range"
  ],
  "sources": [
    "ai-visibility",
    "rank-tracking"
  ],
  "reports": [
    "ai-visibility-report"
  ],
  "skills": [
    "aeo-audit",
    "ai-prompt-coverage-gaps",
    "ai-citation-monitoring"
  ],
  "verbs": [
    "ai_visibility_drilldown"
  ],
  "rungs": [
    "R3"
  ],
  "levers": [
    "L7",
    "L5"
  ],
  "questions": [
    "Who wins the prompts we are missing from?",
    "Which pages beat us on this prompt?",
    "Which prompts produce the most citations at all?"
  ],
  "interpretation": "The client total against the prompt total is the competitive read at prompt grain. A prompt with a large total and a zero client total is the shape a coverage gap takes; a zero total on both sides is a prompt nobody was cited for.",
  "caveats": [
    "The two totals come from two queries joined on the prompt key inside the verb, not from one keyed result set, they are the same query with and without the client filter, which is a narrower guarantee than a single result set.",
    "There is no domain breakdown on this path. The prompt total names no rivals, so a prompt-to-winner-to-URL table cannot be assembled from it.",
    "When the unrestricted leg returns no row for a prompt, the prompt total falls back to your own total, which makes your share of that prompt read as complete rather than unknown.",
    "This is an aggregated cited-page count across all answer-engine runs in the period, not a per-engine sampled share estimate with a confidence interval.",
    "Rows without a cited URL do not contribute, so a domain that was named but not sourced does not appear here.",
    "Engines are non-deterministic: the same prompt can answer differently twice, so these totals count observations over repeated runs."
  ],
  "freshness": "~1 day behind, Daily prompt runs, available the following day.",
  "failureModes": [
    "Assembling a prompt-to-winner-to-URL table by joining separate verb results, this path carries no winner.",
    "Reading a zero client total on a low-total prompt as a competitive loss.",
    "Reading a hundred-percent client share without checking whether the all-domain leg returned a row at all."
  ],
  "notSameAs": [
    {
      "slug": "prompt-cited-pages-count",
      "why": "This counts citation events for the prompt; the cited-pages count counts how many distinct pages of yours the answer drew on, and it comes from a different dataset and a different verb. A prompt can cite one page many times or many pages once."
    },
    {
      "slug": "ai-citation-count",
      "why": "Same behaviour at a different grain, computed on a different dataset, the account-level count is a semantic-layer citation sum, this is a per-prompt row count assembled in the verb. They will not add up."
    },
    {
      "slug": "cited-page-citation-count",
      "why": "Page grain versus prompt grain. One page can be cited across many prompts and one prompt can cite many pages, so neither total decomposes cleanly into the other.",
      "mirroredFrom": "cited-page-citation-count"
    }
  ],
  "related": [
    "cited-page-citation-count",
    "prompt-citation-share",
    "prompt-cited-pages-count",
    "ai-avg-citation-position"
  ],
  "workflows": [],
  "lastVerified": "2026-08-04"
}