There is no public API for audits yet.
/inspect is open and documented here;
audits are driven from the browser with a session. Programmatic access arrives
with API keys — see authentication.What it crawls
Starting from the URL you give it, an audit follows links on the same origin only.blog.example.com is a different origin, and auditing it under the
parent’s name would report on something you did not ask about.
Discovery is, in order:
robots.txt— for the rules, and for anySitemap:it declaressitemap.xml— the site’s own statement of what matters- Links found on the pages themselves, breadth-first
What it will not do
It obeysrobots.txt. A disallowed path is never fetched. It still appears
in the report, marked as skipped, so you know the crawler declined rather than
missed it.
It goes one page at a time, with a pause between requests, and slows down
further if your server starts returning errors. If your robots.txt declares a
Crawl-delay, that is used instead.
Our crawler identifies itself on every request, and explains itself:
Limits
The page ceiling is recorded on each run, so a historical audit still explains
why it stopped where it did after your plan has changed.
An audit also has a time budget that scales with its page limit. A run that
reaches it stops and reports what it covered rather than failing — the report
says so.
Reading the report
The site score is the unweighted mean of the pages that could be scored. Pages that could not be read are counted as crawled but excluded from the mean: a 404 has no metadata to score, and counting it as zero would report a site as broken because one link was stale. It is a mean, so it hides the distribution. That is what the three buckets are for:
A hundred perfect pages and twenty broken ones still average well. The counts
are what tell you that.
Issue categories group every issue code across the site
with the number of pages carrying it — the fastest way to find the one missing
tag that affects two hundred pages. Selecting one filters the page list.
When a page shows an error
A page that could not be read shows what happened rather than a score:
Transient failures are retried once before being recorded. If a page still
shows a 5xx, opening its report will usually succeed — the site was under load
during the crawl, and that page is probably fine.
Comparing two audits
Open a finished audit and choose What changed to see it against the previous finished audit of the same site.
The baseline is the most recent finished audit of the same site, whether you
started it by hand or a monitor did — so a scheduled run
and a manual one can be compared with each other. The first audit of a site has
nothing to compare against, and says so.
The seven watched fields are the same ones monitoring uses:
title,
description, canonical, og:title, og:description, og:image and
twitter:card. Whitespace is normalised, so reflowed templates are not changes.
Audits run before MetaManager began recording page metadata cannot be compared
tag by tag. The comparison says so rather than reporting every tag as changed.
New and fixed issues, and pages that came or went, are still accurate for
those audits.