---
title: "Perform a comprehensive SEO audit on a website"
method: POST
path: "/v3/website-audit/"
tags: ["website-audit"]
---

# Perform a comprehensive SEO audit on a website

`POST /v3/website-audit/`

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

## Request body

- object
  - `url` string — URL to audit (https:// prefixed automatically)
  - `teamId` string — 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)
  - `includeTags` union — HTML tags to include during crawl
    - string
    - string[]
  - `excludeTags` union — HTML tags to exclude during crawl
    - string
    - string[]
  - `urls` string[] — Batch of URLs to audit (alternative to url for Audit Selected). Requires teamId.

## Response `200`

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

- object — 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, nullable
  - `success` boolean
  - `message` string
  - `totalPages` number
  - `results` object[], nullable
    - `url` string
    - `score` number
    - `data` object

## Other responses

- `400` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/versions/6e50f4761eea/schema)