Read the results

Read what an audit found: the main problems, every issue with its pages, page and link records, the folder tree, the crawl log and earlier audits.

Start with the summary: its notes say how complete the audit is (why the crawl stopped early, rate limiting, the external URLs we did not check), then the ten most important problems in plain words, each with the pages it affects, how to fix it and an example. Then go as deep as you need. Every call works during the crawl too, on what was found so far.

#Parameters

#Headers

#Path parameters

#Every way to read an audit

Lists take cursor (from the previous answer) and limit (1 to 1,000, default 100), and answer {cursor, hasMore, items}: pass cursor back while hasMore is true.

#The pages behind one issue

GET /v1/site-audit/{id}/issues/title-duplicate, from an audit of rankfield.dev: the ?tab= addresses repeat the homepage's title.

{
  "cursor": null,
  "hasMore": false,
  "items": [
    {
      "url": "https://rankfield.dev/",
      "status": 200,
      "depth": 0,
      "indexable": true,
      "inlinks": 102,
      "title": "Rankfield — Open web link metrics",
      "titleLength": 33,
      "detail": "3 pages",
      "template": "/"
    },
    {
      "url": "https://rankfield.dev/?tab=key",
      "status": 200,
      "depth": 2,
      "indexable": true,
      "inlinks": 99,
      "title": "Rankfield — Open web link metrics",
      "titleLength": 33,
      "detail": "3 pages",
      "template": "/?tab={v}"
    },
    {
      "url": "https://rankfield.dev/?tab=strength",
      "status": 200,
      "depth": 2,
      "indexable": true,
      "inlinks": 3,
      "title": "Rankfield — Open web link metrics",
      "titleLength": 33,
      "detail": "3 pages",
      "template": "/?tab={v}"
    }
  ],
  "issue": {
    "id": "title-duplicate",
    "name": "Duplicate title",
    "severity": "warning",
    "group": "content",
    "groupName": "Content",
    "subgroup": "",
    "description": "Several indexable pages share this exact title.",
    "fix": "Give each page its own title."
  },
  "of": {
    "set": "indexable",
    "urls": 103,
    "label": "indexable pages"
  },
  "total": 3,
  "columns": [
    "url",
    "status",
    "depth",
    "…"
  ],
  "compared": true
}

#Severity

• error (45 rules): hurts indexing or visitors now, such as a page or internal link that answers 4xx or 5xx, a redirect loop, or a canonical that points at a broken page.
• warning (78 rules): likely costs traffic, such as duplicate pages, thin content, orphan pages, or a linked page served as something other than HTML.
• notice (90 rules): worth a look, such as missing structured data, short titles or missing social cards.

#How counts read

• Names and groups. Each issue has a short name ("404 page", "Title too long"), a description of what was found and a fix, and sits in a group of the report, sometimes in a subgroup.
• URLs affected. An issue's urls counts each URL that has it once, out of the set the rule reads, given in of ({set, urls, label}): every crawled URL of the site (internal), HTML pages that answered 200 (htmlPages), the indexable ones (indexable), redirects, sitemapUrls, or the whole site (site, with no URL count). Read it as "3 of 103 HTML pages". share is the same as a percentage and never passes 100.
• Documents are not HTML pages. Markdown, PDF and other files count in the inventory's documents and only in the internal set.
• Indexable split. Page issues give indexable and notIndexable, so you can tell the pages that matter for search apart.
• Issues found. Per severity, issueTypes is how many kinds of issue were found and affectedUrls how many URL–issue pairs: a URL with three issues counts three times.
• Health score. The share of crawled internal URLs with no error-level issue, 0 to 100, given with its parts in counts.health.
• Change. Against an earlier finished audit of the same site (compare when you name one, else previous, else your latest one), each issue gives change: added (crawled both times, has it now and didn't), new (first crawled now and has it), removed (had it and doesn't), missing (had it and wasn't crawled this time) and net. An issue that is gone shows urls 0.
• History. history gives the issue's urls in up to ten earlier finished audits of the site, oldest first, ending with this one.
• Not checked is never broken. An external URL we did not check carries error: siteExcluded (a site we never fetch, such as the social networks' share links), robotsDisallowed, or botBlocked (its bot protection answered our check with a 401, 403 or 429, or a challenge page; facts.firewall says what we saw). None of them counts as a broken link, in issues, the broken filters or the inventory. status=unchecked lists them, on …/pages and …/links.

#Errors

#MCP

On the MCP server, the tools for this are site_audit_summary, site_audit_issues, site_audit_issue_pages, site_audit_pages, site_audit_links, site_audit_redirects, site_audit_duplicates, site_audit_orphans, site_audit_templates, site_audit_sitemaps, site_audit_diff, site_audit_export, site_audit_page_filters, site_audit_link_filters, site_audit_structure, site_audit_log and site_audit_history.