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

auditStatus'running' | 'idle'

acceptedUrlsstring[]

acceptedAtstring date-time

Changes

Changed in 3 of the 47 revisions of this API.115

Sep 26, 202668d7cda2843213See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Sep 18, 2026e0163b1c37cb11See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
- ○
  endpoint added
  endpoint-added
Aug 14, 2026c6b2fabd21be1See the full diff
- ○
  endpoint added
  endpoint-added

Full history