---
title: "Preview an audit of selected pages"
method: POST
path: "/v3/seo-audit/selection-preview"
tags: ["SEO Audit"]
---

# Preview an audit of selected pages

`POST /v3/seo-audit/selection-preview`

## Request

- Base URL: `https://api.snowseo.com`
- URL: `https://api.snowseo.com/v3/seo-audit/selection-preview`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/snowseo/apis/snowseo-api/docs/v3/seo-audit/selection-preview/post.ts> (a function with typed inputs; its response is checked against the schema)

Counts which of the selected pages an SEO audit would run and which it would skip (already running, out of scope), without queueing anything or using page audits. Read-only.

## Request body

- object
  - `teamId` string, required: SnowSEO team ID, as returned by list_teams.
  - `selection` union, required
    - object
      - `mode` 'ids', required
      - `ids` string[], required
    - object
      - `mode` 'all', required
      - `filters` object, required
        - `search` string
        - `excluded` 'all' | 'included' | 'excluded'
        - `omitUrls` string[]
        - `issueIds` string[]
        - `geoAudited` boolean
      - `excludedIds` string[], required

## Response `200`

Default Response

- object
  - `eligibility` object
    - `selected` number, required
    - `eligible` number, required
    - `skipped` number, required
    - `byReason` object, required
  - `units` number

## Other responses

- `400`: Default Response

## Changes

- **2026-11-03** `31b321592ad7`: 4 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `message` to the response with the `400` status
  - added the optional property `reference` to the response with the `400` status
  - added the optional property `success` to the response with the `400` status
- **2026-11-01** `6d1dc4928d97`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/seo-audit/selection-preview/post.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) - [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/f64935aae2ec?raw)