SEO Audit

Perform a comprehensive SEO audit on a website

Changed on

Crawls a URL with Firecrawl (Crawl4AI fallback), performs a multi-category SEO audit (Common SEO Issues, Server & Security, Mobile Usability, Advanced SEO), and returns structured results with scores per category. In multiple mode (deep crawl) with async=true, the route returns 200 immediately and saves results to the database in the background. The route accepts both GET (params in querystring) and POST (params in JSON body).

get/v3/seo-audit

Request

  • Base URL: https://api.snowseo.com
  • URL: https://api.snowseo.com/v3/seo-audit
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

urlstring required

URL to audit (https:// prefixed automatically)

teamIdstring

Team ID (required for async multiple mode)

auditType'single' | 'multiple'

Audit mode: single page or deep multi-page crawl

async'true' | 'false'

Enable async background processing (multiple mode only)

string
OR
string[]

HTML tags to include during crawl

string
OR
string[]

HTML tags to exclude during crawl

Response

Preview and multi-page requests return JSON. Single-page audits stream status updates followed by the final result as NDJSON.

unitsnumber
urlstring
titlestring
suggestedBrandstring
screenshotstring nullable
successboolean
messagestring
totalPagesnumber
auditStatus'running' | 'idle'
acceptedUrlsstring[]
acceptedAtnumber

Changes

  • 7ede4ba45814Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • bacef4f4b22cRevision changes
    • breaking

      the response's property type changed from string to number, and format from date-time to no format for status