# Heading Outline Audit

> Heading Outline Audit is a paid API for AI agents from agentreadiness.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Passively audits the heading structure (H1–H6 outline) of a public URL and returns an observation, threshold, verdict, evidence source, limitations, and recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/heading-outline-audit?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heading-outline-audit-0391698b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zpq2gPrZuP4hB1x5C5TuU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability heading-outline-audit-0391698b -d '<json body>'
```

Example prompt: Can you audit the heading outline on https://example.com and tell me whether the H1–H6 structure passes, what the exact evidence is, and what I should fix?

## When to prefer this

Use this endpoint when you need a fast, passive, read-only evaluation of a public page's heading hierarchy — particularly for SEO audits, accessibility reviews, or agent-readiness checks. Prefer it over generic HTML scrapers because it returns a structured verdict with threshold, evidence source, and actionable recommendation, not raw HTML. Use the compare_url parameter when you want to diff two pages' heading structures.

## Known failure modes

- Target URL is unreachable or returns a non-200 status — audit cannot proceed
- Target page has no headings at all — observation returns empty outline
- Dynamic/JavaScript-rendered pages may not expose heading structure to passive fetch
- Rate limiting or bot-blocking on the target site may prevent evidence retrieval
- Malformed or extremely large HTML may cause incomplete parsing

## How this service works

Heading outline audit fetches current public evidence from the supplied target and evaluates the documented criterion. It returns the observation, threshold, verdict, exact evidence source, limitations and a mode-specific action. The check is passive: no login attempt, payload injection, exploit, purchase, form submission or load test is performed.

## Output

Returns a structured audit result containing: the observed heading outline from the target page, the evaluation threshold applied, a pass/fail/warning verdict, the exact URL or source where evidence was found, known limitations of the passive check, and a mode-specific action recommendation. No authentication, form submission, or intrusive testing is performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Public HTTP(S) URL or domain to inspect. A bare domain is normalized to HTTPS."
  },
  "context": {
   "type": "object",
   "description": "Optional non-secret correlation labels returned unchanged only in the request lifecycle.",
   "maxProperties": 12,
   "additionalProperties": {
    "type": [
     "string",
     "number",
     "boolean",
     "null"
    ]
   }
  },
  "baseline": {
   "type": [
    "object",
    "null"
   ],
   "description": "Optional baseline returned by a previous snapshot call.",
   "additionalProperties": true
  },
  "compare_url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Optional public comparison URL. Used by change and monitoring services."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heading-outline-audit-0391698b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreadiness.halowerk.com](https://www.zero.xyz/host/agentreadiness.halowerk.com/llms.txt)