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

# Perform a comprehensive SEO audit on a website

`GET /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).

## Query parameters

- `url` string, required
- `teamId` string
- `auditType` 'single' | 'multiple'
- `async` 'true' | 'false'
- `includeTags` union
  - string
  - string[]
- `excludeTags` union
  - string
  - string[]

## 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/aa8eaa9e34a0/schema)