---
title: "Instant on-page audit of a URL"
method: POST
path: "/v1/data/seo/page-audit"
tags: ["SEO: Site audit"]
---

# Instant on-page audit of a URL

`POST /v1/data/seo/page-audit`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/seo/page-audit`
- Auth: API key in header `Authorization`

Fetches a single URL and returns its full on-page SEO signals instantly: title/meta/heading structure, content stats, internal and external link counts, load timings, and every detected on-page issue (missing tags, thin content, broken elements). The cheapest call in this source. Use it per-page; for whole-site crawls a page-by-page loop over the site's key URLs works well.

## Request body

- object
  - `url` string, uri, required: The page URL to audit (with protocol).
  - `enable_javascript` boolean: Render JavaScript before auditing. Slower; only for JS-rendered pages.

## Response `200`

On-page metrics and detected issues for the page in `result[0].items`.

- object

## Other responses

- `400`: Bad request or upstream task error.
- `401`: Unauthorized.
- `429`: Too many requests.
- `5XX`: Upstream error.

---

[API](https://skmtc.dev/superagnt/apis/superagnt-api.md) · [All operations](https://skmtc.dev/superagnt/apis/superagnt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superagnt/apis/superagnt-api/revisions/b2d8de30ccf0?raw)