---
title: "Get AI visibility overview"
method: GET
path: "/ai-visibility"
tags: ["AI Visibility"]
---

# Get AI visibility overview

`GET /ai-visibility`

## Request

- Base URL: `https://next.frase.io/api/v1`
- URL: `https://next.frase.io/api/v1/ai-visibility`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY`

Get an overview of your brand visibility across AI platforms.

## Query parameters

- `days` integer

## Response `200`

AI visibility overview

- AIVisibilityOverview
  - `overview` object
    - `total_prompts` integer
    - `avg_visibility_score` number, nullable: Average visibility score over the prompts measured in the window: each prompt's latest measured answer per platform, averaged per prompt and then across prompts. Null when no prompt was measured in the window. Changed 2026-09-19: previously each prompt's cached latest score, regardless of window.
    - `share_of_voice` number, nullable: Brand share of voice over the window's measured answers (brand presence over brand plus competitor presence), one decimal. Null when no prompt was measured in the window (documented 2026-09-19; previously undocumented and 0 with nothing measured). Changed 2026-10-01: a name that is an ordinary word or a place, or is made only of them ("Landing", "Home Instead", "Visit Mobile"), counts only where the answer writes it as a name, every significant word capitalised, or links the entity's own site; answers read from this date on are counted this way, and a re-read applies it to earlier days.
    - `total_checks` integer
    - `total_mentions` integer
    - `total_citations` integer
    - `period_days` integer
  - `platform_breakdown` object[]
    - `platform` string
    - `checks` integer
    - `mentions` integer
    - `citations` integer
    - `mention_rate` integer: Mention rate as percentage (0-100)
    - `citation_rate` integer: Citation rate as percentage (0-100)
  - `prompts` object[]
    - `id` string, uuid
    - `prompt` string
    - `category` string, nullable
    - `brand_name` string
    - `platforms` string[]
    - `visibility_score` number, nullable: The prompt's visibility score over the window: its latest measured answer per platform, averaged. Null when the prompt has no measured answer in the window. Changed 2026-09-19: previously the prompt's cached latest score (one answer on one platform, regardless of window); the overview's avg_visibility_score is the mean of these.
    - `is_cited` boolean
    - `is_visible` boolean
    - `status` 'cited' | 'visible' | 'not_visible' | 'unmeasured': Verdict of the prompt's latest measured answer per platform. `unmeasured` (added 2026-09-18): no measured answer in the window - never analyzed, failed, or marked unscoreable; `visibility_score` is null then.
    - `last_tracked_at` string, date-time, nullable
    - `created_at` string, date-time
  - `daily_trend` object[]
    - `date` string, date
    - `visibility_score` number, nullable
    - `total_checks` integer, nullable
    - `mentions` integer, nullable
    - `citations` integer, nullable

---

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