---
title: "Preview a site-wide GEO audit"
method: POST
path: "/v3/geo-audit/site-preview"
tags: ["GEO Audit"]
---

# Preview a site-wide GEO audit

`POST /v3/geo-audit/site-preview`

## Request

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

Reports whether a GEO audit would start for the site (or be skipped because one is already running) and how many credits it would use, without starting it. Takes the same body as run_geo_audit. Read-only.

## Request body

- object
  - `teamId` string, required: SnowSEO team ID, as returned by list_teams.
  - `url` string: Optional site URL to audit. Defaults to the team's configured website.

## Response `200`

Default Response

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

## Changes

- **2026-11-01** `6d1dc4928d97`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/geo-audit/site-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)