> ## Documentation Index
> Fetch the complete documentation index at: https://snowseo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Preview GEO Audit

> Check whether a site-wide GEO audit would start and what it would cost, without starting it.

Read-only. Takes `teamId` and an optional `url` (defaults to the team's website), like `POST /v3/geo-audit/site`. Returns `eligibility` (`{ selected, eligible, skipped, byReason }`) and `units`, the page audits it would use: 0 for your brand's own site, 1 for any other site. A site whose audit is already running is skipped with reason `already-running`.


## OpenAPI

````yaml POST /v3/geo-audit/site-preview
openapi: 3.0.0
info:
  title: SnowSEO API
  description: API documentation for SnowSEO
  version: 1.0.0
servers:
  - url: https://api.snowseo.com
    description: Production server
security:
  - bearerAuth: []
  - apiKey: []
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/geo-audit/site-preview:
    post:
      tags:
        - GEO Audit
      summary: Preview a site-wide GEO audit
      description: >-
        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.
      operationId: previewGeoSiteAudit
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - teamId
              properties:
                teamId:
                  type: string
                  minLength: 1
                  description: SnowSEO team ID, as returned by list_teams.
                url:
                  type: string
                  description: >-
                    Optional site URL to audit. Defaults to the team's
                    configured website.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  eligibility:
                    type: object
                    required:
                      - selected
                      - eligible
                      - skipped
                      - byReason
                    properties:
                      selected:
                        type: number
                      eligible:
                        type: number
                      skipped:
                        type: number
                      byReason:
                        type: object
                        additionalProperties:
                          type: number
                  units:
                    type: number
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your SnowSEO API key (sk_...).
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.