---
title: "Get AI visibility"
method: GET
path: "/api/v1/public/brands/{brandSlug}/visibility/overview/"
tags: ["Public: Visibility"]
---

# Get AI visibility

`GET /api/v1/public/brands/{brandSlug}/visibility/overview/`

## Request

- Base URL: `https://api.iterant.ai`
- URL: `https://api.iterant.ai/api/v1/public/brands/{brandSlug}/visibility/overview/`
- Auth: HTTP bearer

One projection per call, selected with `view`:

- `kpis`: visibility score, share of voice, rank, average position and citation share, each with its previous value
- `trend`: the same headline numbers over time
- `share_of_voice`: the entity leaderboard, brand and competitors together
- `platform_matrix`: the same picture split by assistant
- `prompt_scores`: per tracked prompt, how often the brand is mentioned
- `citation_gaps`: domains assistants cite for competitors but not for this brand
- `top_sources`: what assistants cite most in this category

Start at `kpis` and follow the weak number into the view that explains it.

If `enabled` is false, tracking is off for this brand and every row is empty. That is an absence of measurement, not a score of zero.

## Path parameters

- `brandSlug` string, required

## Query parameters

- `limit` string
- `platform` 'chatgpt' | 'gemini' | 'google_ai_overview'
- `responseFormat` 'concise' | 'detailed'
- `view` 'citation_gaps' | 'kpis' | 'platform_matrix' | 'prompt_scores' | 'share_of_voice' | 'top_sources' | 'trend'
- `window` '28d' | '7d' | '90d'

## Response `200`

- PublicVisibilityReport
  - `brandSlug` string, required
  - `enabled` boolean, required: False means tracking is off for this brand: rows are empty because nothing was measured.
  - `view` string, required
  - `windowDays` integer, required
  - `startDate` string, nullable, required
  - `endDate` string, nullable, required
  - `completedRuns` integer, required
  - `platform` string, required
  - `rows` unknown, required
  - `note` string, required

## Other responses

- `400`
- `401`
- `404`
- `405`
- `406`
- `415`
- `429`
- `500`

---

[API](https://skmtc.dev/iterant/apis/iterant-public-api.md) · [All operations](https://skmtc.dev/iterant/apis/iterant-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/iterant/apis/iterant-public-api/revisions/8d62f6ac9cbd?raw)