SEO Audit
developer/v1/domain/seo-auditPerforms a comprehensive on-page SEO audit including title tags, meta descriptions, heading hierarchy, image alt text, internal/external links, content quality, Open Graph, and Twitter Card validation.
What It Does
Fetches the target page and analyzes all on-page SEO elements: title tag length and optimization, meta description quality, heading hierarchy (H1-H6) for proper structure, image alt text coverage, internal and external link ratios, content word count and keyword density, Open Graph completeness, and Twitter Card validation. Returns a score (0-100), letter grade, and actionable recommendations.
Why It's Useful
On-page SEO directly impacts search engine rankings and click-through rates. This audit surfaces issues that are invisible to the naked eye — missing alt text, duplicate headings, thin content, and incomplete social meta tags — so you can fix them before they hurt rankings.
Use Cases
Content Audit
Audit pages across a website to identify SEO issues like missing meta descriptions, thin content, or broken heading hierarchy.
Prioritize fixes by impact to improve organic search rankings.
Pre-publish Check
Run an SEO audit on new pages before publishing to ensure all on-page elements meet standards.
Catch SEO issues before search engines index the page.
Competitor Page Analysis
Analyze competitor landing pages to understand their on-page optimization strategy.
Identify content gaps and optimization opportunities versus competitors.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | The domain to perform the SEO audit onExample: example.com |
Response Fields
| Field | Type | Description |
|---|---|---|
domain | string | The audited domain |
title | object | Title tag analysis: text, length, isOptimal, recommendation |
metaDescription | object | Meta description analysis: text, length, isOptimal |
headings | object | Heading hierarchy (H1-H6), proper order, duplicates |
images | object | Image alt text coverage and quality breakdown |
links | object | Internal/external link counts and ratios |
content | object | Word count and top keyword density |
openGraph | object | OG tag completeness and missing tags |
twitterCard | object | Twitter Card completeness and missing tags |
score | number | SEO score 0-100 |
grade | string | Letter grade A-F |
gradeDescription | string | Human-readable description of the grade (e.g., "Very Good - strong posture") |
breakdown | object | Per-component score breakdown with max weights: title (18), metaDescription (13), headings (13), content (16), imageAlt (10), links (10), duplicateMeta (5), keywords (5), canonical (4), structuredData (4), hreflang (2) |
recommendations | array | Actionable improvement suggestions |
Code Examples
curl "https://api.edgedns.dev/v1/domain/seo-audit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain=example.com"const response = await fetch(
'https://api.edgedns.dev/v1/domain/seo-audit?domain=example.com',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/domain/seo-audit',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': 'example.com'
}
)
data = response.json()
print(data)Read the full SEO Audit guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.