---
title: "AI Visibility Score"
method: GET
path: "/sites/{siteId}/visibility"
---

# AI Visibility Score

`GET /sites/{siteId}/visibility`

## Request

- Base URL: `https://promvia.app/api/v1`
- URL: `https://promvia.app/api/v1/sites/{siteId}/visibility`
- Auth: HTTP bearer

Score, rank (with its basis caveat) and share of voice. shareOfVoicePct ships shareOfVoiceSample: the citation counts behind it, a 95% Wilson interval and tooThin. The score itself is a weighted index, not a proportion — scoreBasis states its weights and says why it carries no interval. score.modelVersion names the formula (scores under different versions are not comparable); score.thinBasis is { questionsNamingYou, threshold } while fewer than threshold of your questions have an answer that names you, the size at which one answer can move the score by many points, and null otherwise. rivals is the dashboard's competitor ranking over the same answer slots: the top five businesses by share, plus your own row (you: true) with its real rank when it is not among them, each with rank (null on your row while you hold no answer slot), shareOfVoicePct and its shareOfVoiceSample, a domain (null, with the listed name in name, for a competitor known only by name), and versusYou — 'tied' whenever the two 95% intervals overlap, 'ahead'/'behind' only when they do not. rivalsBasis states the denominator; rivals is empty until a check has completed.

## Path parameters

- `siteId` string, required

## Response `200`

AI Visibility Score

## Other responses

- `401`: Missing/invalid API key.
- `402`: API access requires a Pro or Agency plan.
- `403`: The key's account holds a seat in another workspace — API keys are owner credentials.
- `404`: Site not found (or not yours).
- `429`: Per-minute rate limit or the monthly request pool exceeded. A monthly-pool 429 names the limit and reset date in the body and X-RateLimit headers; the burst 429 just asks you to retry shortly.

---

[API](https://skmtc.dev/promvia/apis/promvia-api.md) · [All operations](https://skmtc.dev/promvia/apis/promvia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/promvia/apis/promvia-api/revisions/3f058e1d6016?raw)