Skip to main content

SEO Audit

developer
GET/v1/domain/seo-audit

Performs 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

SEO Specialist

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.

Content Editor

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.

Content Strategist

Competitor Page Analysis

Analyze competitor landing pages to understand their on-page optimization strategy.

Identify content gaps and optimization opportunities versus competitors.

Parameters

NameTypeRequiredDescription
domainstringRequiredThe domain to perform the SEO audit onExample: example.com

Response Fields

FieldTypeDescription
domainstringThe audited domain
titleobjectTitle tag analysis: text, length, isOptimal, recommendation
metaDescriptionobjectMeta description analysis: text, length, isOptimal
headingsobjectHeading hierarchy (H1-H6), proper order, duplicates
imagesobjectImage alt text coverage and quality breakdown
linksobjectInternal/external link counts and ratios
contentobjectWord count and top keyword density
openGraphobjectOG tag completeness and missing tags
twitterCardobjectTwitter Card completeness and missing tags
scorenumberSEO score 0-100
gradestringLetter grade A-F
gradeDescriptionstringHuman-readable description of the grade (e.g., "Very Good - strong posture")
breakdownobjectPer-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)
recommendationsarrayActionable improvement suggestions

Code Examples

cURL
curl "https://api.edgedns.dev/v1/domain/seo-audit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=example.com"
JavaScript
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);
Python
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.

Try This Endpoint

Test the SEO Audit endpoint live in the playground.