SEO Audit

Perform a comprehensive SEO audit on a website

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

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.

urlstring
titlestring
suggestedBrandstring
screenshotstring nullable
successboolean
messagestring
totalPagesnumber
jobIdstring nullable

Changes