Audit a web page by URL

POST/v1/tools/web.page.audit/callsNeeds an API key

Fetches one web page and returns its on-page facts: status code, title, description, canonical URL, H1, link counts, size and load time. Use it to check a page's technical health.

Tool web.page.audit on Open web and SEO. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

urlstringRequired

Address of the public page to audit, starting with http:// or https://. The page is fetched when called.

Format uri.

Matches ^https?://[^\s/?#]+\S*$.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`page`

One object. Can be null.

urlstringRequired

Address of the page that was audited.

status_codeintegerRequired

HTTP status code the page answered with.

redirect_urlstring

Where the page redirects to. Absent when it does not redirect.

content_typestring

Media type of the page, such as "text/html".

titlestring

Text of the page's title element.

descriptionstring

The page's meta description.

canonical_urlstring

Address the page declares as canonical.

h1array of string

Text of each h1 heading, in page order.

word_countinteger

Words of readable text on the page.

internal_link_countinteger

Links to pages of the same site.

external_link_countinteger

Links to other sites.

image_countinteger

size_bytesinteger

Size of the page's HTML, in bytes.

load_time_msinteger

Time to load the page, in milliseconds.

scorenumber

The provider's on-page SEO score, from 0 (worst) to 100. Each provider computes its own.

fetched_atstring

When the page was fetched, as an ISO 8601 timestamp in UTC.

curl https://api.voxoria.ai/v1/tools/web.page.audit/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://moz.com/"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/web.page.audit/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"url": "https://moz.com/"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/web.page.audit/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"url": "https://moz.com/"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "web.page.audit",
    "input": {
      "url": "https://moz.com/"
    }
  }
}

200 OKoutputapplication/json

{
  "page": {
    "url": "https://moz.com/",
    "status_code": 200,
    "redirect_url": null,
    "content_type": "text/html",
    "title": "Moz - SEO Software for Smarter Marketing",
    "description": "Backed by the largest community of SEOs on the planet, Moz builds the tools that make SEO, content marketing, market research, digital PR, and local SEO easy. Start your free trial today!",
    "canonical_url": "https://moz.com/",
    "h1": [
      "Show up in search. Show up in AI. \nOwn the results."
    ],
    "word_count": 2233,
    "internal_link_count": 82,
    "external_link_count": 11,
    "image_count": 40,
    "size_bytes": 165475,
    "load_time_ms": 20,
    "score": 97.07,
    "fetched_at": "2026-10-28T04:25:27Z"
  }
}

The output of a real call, each list cut to 3 items.