SEO audit API
Crawl a site within strict limits and return a scored, prioritized fix list with evidence URLs.
Example
curl -s -X POST https://audit.45-94-66-237.sslip.io/v1/run/seo.audit \
-H "Authorization: Bearer $SITEAUDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"example.com","competitors":["example.org"]}'
from siteaudit_client import Client
client = Client() # reads SITEAUDIT_API_KEY
result = client.run('seo.audit', {'domain': 'example.com', 'competitors': ['example.org']})
print(result['cost_usd'], result['output'])
const res = await fetch("https://audit.45-94-66-237.sslip.io/v1/run/seo.audit", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SITEAUDIT_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({"domain": "example.com", "competitors": ["example.org"]}),
});
const run = await res.json();
console.log(run.cost_usd, run.output);
Sample response
Illustrative and trimmed: a fictional site in the free site mode. Real responses carry more fields; see Output below.
{
"ok": true,
"request_id": "req_3f9a1c7e5b2d4a60",
"endpoint": "seo.audit",
"status": "succeeded",
"cost_usd": 1.0,
"items": 1,
"latency_ms": 4310,
"source": {
"id": "site",
"name": "First-party crawl",
"kind": "first_party",
"demo": false
},
"output": {
"report_id": "aud_8c41e2b07d9f3a15",
"summary": {
"score": 68,
"diagnosis": "Crawling works, but on-page basics are uneven: four pages have no description and two share a title.",
"site_scores": {
"crawl_index": 84,
"on_page": 55,
"content": 66,
"performance": 72
}
},
"actions": [
{
"priority": 1,
"action": "Write a unique meta description for each listed page",
"title": "4 page(s) have no meta description",
"impact": "medium",
"effort": "low",
"category": "on_page",
"finding_id": "missing_meta_description",
"affected": 4,
"evidence": [
"https://example.com/pricing",
"https://example.com/about"
]
}
],
"plan": {
"now": [
1
],
"next": [
2,
3
],
"later": [
4
]
},
"technical_issues": [
{
"id": "missing_meta_description",
"issue": "4 page(s) have no meta description",
"severity": "medium",
"category": "on_page",
"count": 4,
"affected_urls": [
"https://example.com/pricing"
],
"fix": "Write a 120–155 character description per page."
}
],
"not_covered": [
"Search volumes and keyword positions (needs a licensed keyword source)",
"Backlinks"
],
"partial": false
}
}
Cost at volume
You pay : $1.00 per report, no plan, nothing when idle. Failed calls are not charged.
Input
| Field | Type | Required | Default |
|---|---|---|---|
domain | string | yes | |
competitors | array | no | |
location | string | no | "us" |
language | string | no | "en" |
focus | string (all | content | backlinks | technical) | no | "all" |
Output
Inside output of the run envelope:
| Field | Meaning |
|---|---|
report_id | Stable id of the stored report. |
summary | Overall score, sub-scores and a one-paragraph diagnosis. |
actions | Ranked fixes, each with impact, effort, evidence URLs and the finding it resolves. |
plan | Actions grouped into now / next / later. |
technical_issues | Crawl, indexing, on-page, content and speed findings. |
keyword_gaps | Competitor topics or keywords the site lacks (data depends on mode). |
not_covered | What this mode could not measure, instead of invented numbers. |
sources | Every data source used, with what it contributed. |
partial | True when a non-critical source failed; the report is still billed. |
What it checks
Crawlability (9), Security (4), Indexability (7), On-page (7), Mobile (1), Accessibility (2), Content (4), Performance (4). 38 checks in total, each documented in the check reference.
Measured performance
No calls measured on this server in the last 30 days yet, so there is no latency or success rate to show. Numbers appear here once real traffic exists; nothing is estimated.
Counted on this server, recomputed on every page view. Not a guarantee or an SLA.
Questions
How much does SEO audit cost?
$1.00 per report, drawn from a prepaid USD wallet. The exact amount is on every response as cost_usd, and max_cost_usd lets you refuse anything higher.
Can I check the price before running?
Yes. POST /v1/quote/seo.audit with the same body validates the input and returns the price and whether your wallet can pay. It is free.
How reliable is it?
The numbers above are measured on this server's own calls over 30 days. There is one data source per mode and no automatic failover; failed calls are refunded.
Can an agent call it?
Yes, as the MCP tool run_endpoint with endpoint: "seo.audit", or through the CLI and SDKs.
Markdown version for agents: /docs/api/seo.audit.md
Run the full audit on your site. One call checks every item in the check reference and ranks the fixes.
Open the playground Endpoint details