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

# Run a site-wide GEO audit

`POST /v3/geo-audit/site`

Starts a GEO (generative engine optimisation) audit of the site - how well its content can be understood and cited by AI answer engines. Runs in the background; poll geo_audit_site for status and results. Competitor audits consume plan credits.

## Request body

- object
  - `teamId` string, required — SnowSEO team ID. Call list_teams first to choose a team.
  - `url` string — Optional site URL to audit. Defaults to the team's configured website.

## Response `200`

Default Response

## Changes

- **2026-08-14** `c6b2fabd21be` — 2 info
  - api operation id `runGeoSiteAudit` was added
  - api tag `GEO Audit` added
- **2026-08-02** `fc71da85b381` — 1 info
  - endpoint added

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