Skip to main content
POST
/
v3
/
website-audit
Perform a comprehensive SEO audit on a website
curl --request POST \
  --url https://api.snowseo.com/v3/website-audit/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "teamId": "<string>",
  "auditType": "single",
  "async": "true",
  "includeTags": "<string>",
  "excludeTags": "<string>"
}
'
{
  "url": "<string>",
  "title": "<string>",
  "suggestedBrand": "<string>",
  "seoAudit": {},
  "screenshot": "<string>",
  "success": true,
  "message": "<string>",
  "totalPages": 123,
  "results": [
    {
      "url": "<string>",
      "score": 123,
      "data": {}
    }
  ]
}
Analyze any website for SEO issues, performance problems, and optimization opportunities. The audit checks things like broken links, missing meta tags, page speed, mobile-friendliness, and more. You can also use GET for this endpoint — both methods work the same way.

​
Key fields explained

FieldWhat It Tells You
overallScoreYour website’s SEO health score out of 100
totalTests / passedTestsHow many checks were run and how many your site passed
categoryScoresScores broken down by area — SEO issues, security, mobile, and advanced SEO
timestampWhen the audit was run
resultsDetailed findings for each check, including whether it passed and specific data (e.g., missing image alt tags, meta title length)
The full response includes many more checks inside results (heading tags, social media tags, robots.txt, sitemap, etc.). Each check includes a passed field and specific details about what was found.
Run audits regularly (e.g., weekly) to catch new issues early — especially after deploying changes to your website.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
url
string
required

URL to audit (https:// prefixed automatically)

​
teamId
string

Team ID (required for async multiple mode)

​
auditType
enum<string>
default:single

Audit mode: single page or deep multi-page crawl

Available options:
single,
multiple
​
async
enum<string>
default:true

Enable async background processing (multiple mode only)

Available options:
true,
false
​
includeTags

HTML tags to include during crawl

​
excludeTags

HTML tags to exclude during crawl

Response

Union of single-page, preview, async multiple, and sync multiple shapes. additionalProperties is required so fast-json-stringify does not strip nested audit fields.

Union of single-page, preview, async multiple, and sync multiple shapes. additionalProperties is required so fast-json-stringify does not strip nested audit fields.

​
url
string
​
title
string
​
suggestedBrand
string
​
seoAudit
object
​
screenshot
string | null
​
success
boolean
​
message
string
​
totalPages
number
​
results
object[] | null