---
title: "Latest citations per query"
method: GET
path: "/sites/{siteId}/citations"
---

# Latest citations per query

`GET /sites/{siteId}/citations`

## Request

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

Per-query mention state, cited URLs, sentiment with sentimentSource (model = read by Claude Haiku on paid plans; keyword = the keyword estimate; null = no sentiment, e.g. the answer only repeated the question), share of voice. shareOfVoicePct ships shareOfVoiceSample: the citation counts, a 95% Wilson interval and tooThin. demandBand per query: how often it is asked, as a band (rare | occasional | frequent), null when unmeasured or not on a paid plan — never a count.

## Path parameters

- `siteId` string, required

## Response `200`

Latest citations per query

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