Website Audit
Performs a comprehensive SEO and AI-readiness audit of a specified URL. The audit analyzes:
- Site files (robots.txt, llms.txt)
- SEO fundamentals (title, description, headings)
- Structured data (Schema.org, JSON-LD)
- Content structure and semantic HTML
- Image accessibility
- Automation readiness for AI agents
- JavaScript rendering and bot accessibility
Returns an overall score (0-100) and detailed recommendations for improvement.
Request Body required
The full URL of the website to audit
- 200
- 401
- 422
Successful audit response
Schema
- Array [
- ]
Indicates if the audit was successful
data object
The audited URL (may include trailing slash)
The base domain of the audited URL
ISO 8601 timestamp of when the audit was performed
Possible values: <= 100
Overall SEO and AI-readiness score (0-100)
High-level summary of the audit findings
siteFiles object
Possible values: [Excellent
, Good
, Needs Improvement
, Poor
, Not Applicable
]
Overall status of site files
Detailed explanation of site files evaluation
Possible values: [found
, not_found
, error
]
Status of robots.txt file
Possible values: [found
, not_found
, error
]
Status of llms.txt file (AI model instructions)
botAccess object
Possible values: [allowed
, disallowed
, not_specified
]
Possible values: [allowed
, disallowed
, not_specified
]
Possible values: [allowed
, disallowed
, not_specified
]
seoFundamentals object
Possible values: [Excellent
, Good
, Needs Improvement
, Poor
, Not Applicable
]
Page title tag content
Meta description content
Number of H1 headings on the page
structuredData object
Possible values: [Excellent
, Good
, Needs Improvement
, Poor
, Not Applicable
]
Whether schema.org markup is present
Whether JSON-LD structured data is present
List of detected schema types
contentStructure object
Possible values: [Excellent
, Good
, Needs Improvement
, Poor
, Not Applicable
]
Possible values: <= 10
Score for semantic HTML usage (0-10)
imageAccessibility object
Possible values: [Excellent
, Good
, Needs Improvement
, Poor
, Not Applicable
]
Possible values: <= 100
Percentage of images missing alt text
Total number of images on the page
Number of images without alt text
automationReadiness object
Possible values: [Excellent
, Good
, Needs Improvement
, Poor
, Not Applicable
]
List of issues affecting automation readiness
jsRendering object
Possible values: [Excellent
, Good
, Needs Improvement
, Poor
, Not Applicable
]
Detected JavaScript framework (React, Vue, Angular, etc.)
Possible values: [Static
, SSR
, CSR
, Hybrid
]
Type of rendering used by the site
Possible values: [Excellent
, Good
, Fair
, Poor
]
How accessible the content is to AI agents
Description of content availability in HTML
Recommendations for improving JS rendering
quickWins object[]
Title of the quick win recommendation
Detailed description of the recommendation
Possible values: [High
, Medium
, Low
]
Expected impact of implementing this recommendation
Possible values: [completed
, pending
, failed
]
Status of the audit process
Account ID associated with the audit
Account URL associated with the audit
{
"success": true,
"data": {
"url": "string",
"domain": "string",
"timestamp": "2025-10-16T08:06:32.201Z",
"overallScore": 0,
"summary": "string",
"siteFiles": {
"status": "Excellent",
"explanation": "string",
"robotsTxt": "found",
"llmsTxt": "found",
"botAccess": {
"gptbot": "allowed",
"claude": "allowed",
"googlebot": "allowed"
}
},
"seoFundamentals": {
"status": "Excellent",
"explanation": "string",
"title": "string",
"description": "string",
"h1Count": 0
},
"structuredData": {
"status": "Excellent",
"explanation": "string",
"hasSchema": true,
"hasJsonLd": true,
"detectedSchemas": [
"string"
]
},
"contentStructure": {
"status": "Excellent",
"explanation": "string",
"semanticHtmlScore": 0
},
"imageAccessibility": {
"status": "Excellent",
"explanation": "string",
"missingAltPercentage": 0,
"totalImages": 0,
"imagesWithoutAlt": 0
},
"automationReadiness": {
"status": "Excellent",
"explanation": "string",
"issues": [
"string"
]
},
"jsRendering": {
"status": "Excellent",
"explanation": "string",
"frameworkDetected": "string",
"renderingType": "Static",
"aiAccessibility": "Excellent",
"contentAvailability": "string",
"recommendations": [
"string"
]
},
"quickWins": [
{
"title": "string",
"description": "string",
"impact": "High"
}
],
"status": "completed",
"accountId": 0,
"accountUrl": "string"
}
}
Successful audit
{
"success": true,
"data": {
"url": "https://example.com/",
"domain": "https://example.com",
"timestamp": "2025-10-16T07:52:01.581Z",
"overallScore": 35,
"summary": "The website is a basic example domain, primarily intended for documentation.",
"siteFiles": {
"status": "Poor",
"explanation": "Neither robots.txt nor llms.txt are present.",
"robotsTxt": "not_found",
"llmsTxt": "not_found",
"botAccess": {
"gptbot": "not_specified",
"claude": "not_specified",
"googlebot": "not_specified"
}
},
"seoFundamentals": {
"status": "Poor",
"explanation": "The site has a title tag but lacks a meta description.",
"title": "Example Domain",
"description": null,
"h1Count": 1
},
"structuredData": {
"status": "Poor",
"explanation": "No schema.org markup is present.",
"hasSchema": false,
"hasJsonLd": false,
"detectedSchemas": []
},
"contentStructure": {
"status": "Needs Improvement",
"explanation": "The content is very basic.",
"semanticHtmlScore": 6
},
"imageAccessibility": {
"status": "Not Applicable",
"explanation": "There are no images on the page.",
"missingAltPercentage": 0,
"totalImages": 0,
"imagesWithoutAlt": 0
},
"automationReadiness": {
"status": "Poor",
"explanation": "The lack of structured data and robots.txt/llms.txt hinders automation.",
"issues": [
"Missing robots.txt",
"Missing llms.txt",
"Lack of structured data"
]
},
"jsRendering": {
"status": "Good",
"explanation": "The website appears to be statically rendered with minimal to no JavaScript.",
"frameworkDetected": "None",
"renderingType": "Static",
"aiAccessibility": "Excellent",
"contentAvailability": "All content in HTML",
"recommendations": []
},
"quickWins": [
{
"title": "Add a Meta Description",
"description": "Implement a meta description tag in the <head> section.",
"impact": "Medium"
},
{
"title": "Implement robots.txt",
"description": "Create a robots.txt file to explicitly define crawling rules.",
"impact": "Medium"
}
],
"status": "completed",
"accountId": 216,
"accountUrl": "https://example.com"
}
}
Unauthorized - Invalid or missing API key
Schema
Error message
{
"success": false,
"error": "string"
}
Validation Error - Invalid request format
Schema
- Array [
- ]
detail object[]
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}