Home / API docs / Seo Site Audit API
SEO & Publishing

Seo Site Audit API

GET /api/seo/site-audit $0.25 per call USDC on Base · x402

SITE-WIDE audit — the full 7-part on-page audit (head/meta, alt text, social cards, links, WCAG, schema.org, robots) run across up to 8 pages of one site in a single call. Discovers pages from the start URL's internal links, audits each, and returns per-page scores plus a site-level score, grade, and the issues that repeat across pages. The finished deliverable: one call, whole-site verdict. ?url=&pages=&level=&detail=

Parameters

NameInDescription
urlqueryrequiredStart URL (usually the homepage)
pagesqueryMax pages to audit, 2-8 (default 5)
levelqueryWCAG level: A, AA (default), AAA
detailquerysummary (default) or full — full includes every per-page section report

Example request

curl "https://api.webbersites.com/api/seo/site-audit?url=https%3A%2F%2Fexample.com&pages=5&level=AA"
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "site": "https://example.com",
    "site_score": 78,
    "grade": "C",
    "pages_audited": 5,
    "pages": [
        {
            "url": "https://example.com/",
            "score": 82,
            "grade": "B",
            "top_issues": [
                "2 head/meta problems"
            ]
        }
    ],
    "common_issues": [
        {
            "reason": "images missing alt",
            "pages_affected": 4
        }
    ]
}
MCP tool: get_seo_site_audit — via npx -y webbersites-x402-mcp (local, key stays on your machine) or the remote endpoint https://api.webbersites.com/mcp.

How payment works

There is no signup and no API key. Call the endpoint; it replies 402 Payment Required with machine-readable payment requirements. Your client signs a USDC transfer authorization (EIP-3009, gasless) and retries with the X-PAYMENT header — @x402/fetch does this automatically. See the overview for a working snippet.