Free tool · no signup · runs now
API catalog checker
One catalog file tells agents where your whole API lives. The checker validates the same linkset the audit requires.
Part of the AI agent discovery checker group — also included in the free full scan.
Checks site-wide files at the domain root — any page URL on the domain gives the same result.
One free scan · anonymous preview · sign in to save the full report
api-catalog valid: 3 anchors with service-descStatic example for API catalog checker; run the check above for your own result.What it checks
See whether your API catalog lists your endpoints the way agents expect.
Linkset+json structure, anchors carrying service-desc links.
Reads the raw JSON only, never renders. Follows up to 5 redirects.
What good looks like
Good looks like a linkset+json document whose anchors each carry a service-desc link — one file mapping your whole API. Malformed catalogs fail; a missing file reports na.
How to fix it
Serve /.well-known/api-catalog as linkset+json with anchors and service-desc entries.
What the full scan adds
- All 34 checks in one pass — one URL, every category, a single report.
- Evidence on every row: the values found, why it fails, the fix, and a deep link per check.
- Your score against the global distribution — see where you stand.
- Sign in and the report is kept for 1 year; anonymous reports expire after 7 days.
Official source: RFC 9727, API catalog · Rule: agent-readiness v1 · checker library
Tracking a Google update? Run the update impact check or read the search update radar.
Frequently asked questions
Is the API catalog checker free?
Yes — one free run without an account, with an anonymous preview. Sign in to save the full report and keep the evidence.
How often should I run it?
After every deploy that touches routing, templates or the checked file — and after each Google core update, to confirm nothing regressed.
Does the check run JavaScript?
No — it reads the no-JS response only, exactly what a crawler or AI agent sees when it fetches the URL.
How is this different from a full audit?
This page runs one check with its full criteria and fix notes. The free full scan runs every category at once and keeps the evidence per URL — use it once you know which checks matter.
What is an API catalog?
An API catalog is a linkset+json document at /.well-known/api-catalog that points agents at the service description for each API. It is the discovery index: an agent reads the catalog first, then follows the service-desc link to the OpenAPI or equivalent file.
How is an API catalog different from OpenAPI?
OpenAPI describes one API’s operations. The catalog is the index that links to one or more service descriptions, so an agent can find the right API before parsing it. Serve both: the catalog for discovery, OpenAPI for the details.