Detect soft 404s across a large site by combining URL Inspection API coverage states with content-based heuristics, then fix root causes

domain: developers.google.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Pull each URL's indexStatusResult from the URL Inspection API and flag entries whose indexingState or coverage reason indicates a soft-404 determination
  2. Cross-reference flagged URLs against your actual HTTP status codes — a soft 404 is a page returning 200 OK whose content Google judges to be an error/empty page
  3. Build a heuristic pass over server responses for pages with near-empty bodies, generic 'not found' phrasing, or content nearly identical to a known error template, even if status is 200
  4. For legitimately empty results (e.g. an out-of-stock or zero-results search page), decide per template whether to return a real 404/410, add substantive fallback content, or explicitly noindex the page
  5. Fix the root template so it returns the correct HTTP status for genuinely missing resources, rather than relying on Google's soft-404 heuristic to sort it out
  6. Re-inspect fixed URLs after redeploy and monitor the Page Indexing report's 'Soft 404' bucket for it to shrink over subsequent recrawls

Known gotchas

Related routes

Detect and remediate soft-404 pages that return HTTP 200 but contain no meaningful content
google-search-console · 5 steps · unrated
Diagnose and fix Google Search Console soft 404 errors
indexing · 5 steps · unrated
Batch URL Inspection API calls within the 2000 QPD quota to audit index status across a large URL set
google-search-console · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans