Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: 'superagnt SEO: Site audit API'
description: Unified API for social media data. Access LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook through a single API key.
version: 1.0.0
contact:
name: superagnt
url: https://superagnt.com
servers:
- url: https://api.superagnt.com
description: superagnt API
security:
- ApiKeyAuth: []
tags:
- name: 'SEO: Site audit'
description: Instant single-page on-page audits.
paths:
/v1/data/seo/page-audit:
post:
operationId: page_audit
summary: Instant on-page audit of a URL
x-agnt-permission: act
description: '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.'
tags:
- 'SEO: Site audit'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- url
properties:
url:
type: string
format: uri
description: The page URL to audit (with protocol).
enable_javascript:
type: boolean
default: false
description: Render JavaScript before auditing. Slower; only for JS-rendered pages.
example:
url: https://example.com/pricing
responses:
'200':
description: On-page metrics and detected issues for the page in `result[0].items`.
content:
application/json:
schema:
type: object
'400':
description: Bad request or upstream task error.
'401':
description: Unauthorized.
'429':
description: Too many requests.
5XX:
description: Upstream error.
security:
- ApiKeyAuth: []
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: 'Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...'