---
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_status for progress and read the result with geo_audit_site. Consumes plan credits and requires an active plan.

## 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

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/c6b2fabd21be/schema)