Skip to main content
GET
Get the site-wide GEO audit result
Get the latest stored GEO audit for your team’s website. The response is { audit, auditStatus }: audit holds domain, overallScore, payload (the checks), and updatedAt (or null when nothing is stored), and auditStatus is running, idle, or failed. Pass your teamId; url is optional and defaults to the team’s configured website. Set scoreOnly=true to omit the checks; the response still includes domain, overallScore, updatedAt (inside audit, or audit: null when nothing is stored) and auditStatus. To start or refresh an audit, call POST /v3/geo-audit/site with teamId and, optionally, url. For your brand’s own site this returns 202 with { queued: true, status: "running" } and runs in the background, so read this endpoint again after it completes. Auditing any other site runs inline, returns the result directly, and uses 1 page audit (402 if your allowance is exhausted). Your team’s first read may also start a free audit automatically when no result exists yet.
This endpoint reads a site-wide audit, not an on-demand audit of a single page. Use the GEO page endpoints for page-level results.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string
required

SnowSEO team ID, as returned by list_teams.

Minimum string length: 1
url
string

Optional site URL. Defaults to the team's configured website.

scoreOnly
string

Return only the overall score and run status, without the payload of checks behind it. A failed rerun is not reported while an earlier audit is stored. Defaults to false.

Response

200 - application/json

Default Response

audit
object | null
auditStatus
enum<string>
Available options:
running,
idle,
failed