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).

post/v3/seo-audit

Request body

urlstring

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)

urlsstring[]

Batch of URLs to audit (alternative to url for Audit Selected). Requires teamId.

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