---
title: "Start a Deep Site Audit (async)"
method: POST
path: "/site-audit"
tags: ["Deep Site Audit"]
---

# Start a Deep Site Audit (async)

`POST /site-audit`

## Request

- Base URL: `https://seoscoreapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://seoscoreapi.com/site-audit`
- Auth: none declared. Required headers: `X-API-Key`

Queue a Deep Site Audit of one URL and get a `job_id` back immediately.

The audit fetches the page and its supporting signals (robots.txt, sitemap,
DNS, TLS, PageSpeed), runs the thousands of catalog checks that apply to it, then an AI analysis pass of up to 150 checks. It takes
about 90 seconds once it starts, so poll `GET /site-audit/{job_id}`.

**Included on Pro (20/month) and Ultra (100/month).** Any other key spends one
purchased Deep Audit credit per audit. A failed audit gives its quota unit or
credit back.

## Headers

- `X-API-Key` string, required

## Request body

- DeepAuditRequest: Start a Deep Site Audit. Unknown fields are passed to the engine untouched.
  - `url` string, required: Page to audit (scheme optional). Must be a public http(s) address.
  - `business_type` string, nullable: Tunes which checks apply: saas | local_service | ecommerce | storefront | blog | publisher. Inferred when omitted.
  - `is_local` boolean, nullable: Force local-business checks (NAP, LocalBusiness schema).
  - `webhook_url` string, nullable: Optional public URL POSTed once when the job completes. Single attempt, no retries, no signature: keep polling as the source of truth.

## Response `200`

Job queued.

- unknown

## Other responses

- `400`: URL or webhook refused (not a public http(s) address).
- `401`: Missing or invalid API key.
- `402`: No Deep Audit credits left (keys without Pro/Ultra). Buy a credit pack or upgrade.
- `422`: Validation Error
- `429`: Rate limit, monthly quota, or queue backpressure. Honour `Retry-After`.
- `503`: Engine temporarily unavailable. Retry after `Retry-After` seconds.

---

[API](https://skmtc.dev/seoscoreapi/apis/seo-score-api.md) · [All operations](https://skmtc.dev/seoscoreapi/apis/seo-score-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seoscoreapi/apis/seo-score-api/revisions/877a3044b5be?raw)