list_priority_pages

list_priority_pages returns the site plan: the fixes to do first, in order. It is an order of what to do first, not a limit: every fix stays open and free, on every page. A plan mixes two kinds of rows. A page fix (kind: "page") is a page of the site that serves tracked prompts, with its issues and the evidence that it matters. A template fix (kind: "template") is one check to fix across pages. The plan is set at the end of each monthly crawl and does not move with daily scans.

When to use

When an agent asks "what should I fix on my site first?". Walk the plan in order: fix the page or the template, mark it done in the dashboard, then move on. For a page row, run_page_fix gives its complete to-do with JSON-LD ready to paste.

Input

Response

{
  "data": [
    {
      "id": "page:example.com/services/seo-audit",
      "blocking": false,
      "score": 8.4,
      "done": null,
      "kind": "page",
      "url": "https://example.com/services/seo-audit",
      "title": "Technical SEO audit for B2B SaaS",
      "effort": "fix",
      "promptIds": ["cmg7z0q1p0002l70f8h3k5m1n"],
      "issues": [
        { "check": "jsonld-missing", "level": "AI_IMPACT", "title": "No structured data for this kind of page" }
      ],
      "evidence": {
        "opened": 6,
        "openedBy": ["CHATGPT", "PERPLEXITY"],
        "silent": 0,
        "absent": 83,
        "competitors": ["Acme SEO", "Rankwise"],
        "crawlerVisits": 41,
        "search": {
          "clicks": 38,
          "impressions": 2140,
          "position": 7.4,
          "previousClicks": 61,
          "clickShare": 4.2,
          "push": true,
          "declining": true,
          "protect": true,
          "cannibalized": [{ "query": "seo audit saas", "urls": ["example.com/blog/seo-audit-checklist"] }]
        }
      }
    },
    {
      "id": "fix:title-duplicate",
      "blocking": false,
      "score": 3.1,
      "done": "2026-10-05T10:00:00.000Z",
      "kind": "template",
      "check": "title-duplicate",
      "title": "Same title on several pages",
      "level": "SEO_HYGIENE",
      "pages": 34
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 2 },
  "summary": { "phase": "priorities", "aiHealth": 78, "promptsWithoutPage": 3 }
}

• Rows come in plan order. blocking rows always come first.
• done: when the fix was marked done, or null.
• effort (page rows): fix when the page needs fixes, rework when the page is thin or only loosely matches its prompts: it needs more content before fixes pay off. Never rework when evidence.search.protect is true.
• With Search Console connected, a page that serves no prompt (promptIds empty) becomes a page row when it has issues and a Google signal. It ranks on its issues alone, behind pages where the brand is missing from AI answers.
• evidence.opened: answers where an engine opened the page on a prompt without citing it. silent: answers citing the page without naming the brand. absent: share of engines that do not name the brand on these prompts, in %. competitors: brands cited instead, most cited first. crawlerVisits: AI robot requests on the page over 30 days. search: the page's Google signals over 28 days, same shape as googleSearch in get_page_fix, null without Search Console.
• summary.phase: blocking while a blocking fix is left, then priorities, then done. aiHealth: share of pages with no blocking or AI-impact issue, in %. promptsWithoutPage: tracked prompts no page of the site answers.
• summary is null and data empty while the site has no diagnostic.

Tips and patterns

• Stick to the order. The ranking weighs AI impact, SEO hygiene and the evidence from tracked answers. Fixes further down are free too, but they move citations less.
• Prompts without a page. A high promptsWithoutPage means the site has no page to cite on those questions: fixing pages will not help there, a new page will.

Related tools

• run_page_fix: start the full fix of a page of the plan.
• list_site_issues: every issue with how to fix it.
• get_site_health: scores per level and every fix.