Visibility

Overview

The visibility endpoint returns three complementary metrics computed from all campaign runs for a brand:

SOV (share of voice) - each brand's percentage of total mentions across LLM responses
Mention rate - the brand's own mention rate (0-100%)
Timeline - day-by-day mention rate over the selected period

Endpoints

Method	Path	Description
`GET`	`/brands/{brandId}/visibility`	SOV, mention rate, and timeline

GET /brands//visibility

Query parameters

Parameter	Type	Default	Description
`days`	integer	`30`	Number of days to look back
`model`	string	-	Filter results to a specific LLM model enum value

curl "https://mentova.ai/api/v1/brands/clxabc123/visibility?days=30" \
  -H "X-API-Key: mtv_live_your_key"

Response `200`

{
  "data": {
    "mentionRate": 42.5,
    "sov": [
      {
        "name": "Acme Corp",
        "mentionRate": 42.5,
        "shareOfVoice": 38.2
      },
      {
        "name": "Rival Inc",
        "mentionRate": 31.0,
        "shareOfVoice": 27.9
      }
    ],
    "timeline": [
      {
        "date": "2026-05-25",
        "mentionRate": 38.0
      },
      {
        "date": "2026-05-26",
        "mentionRate": 44.5
      }
    ]
  }
}

Response fields

Field	Type	Description
`mentionRate`	number	Brand's mention rate as a percentage (0-100)
`sov`	array	Share-of-voice leaderboard. Each entry has `name`, `mentionRate`, and `shareOfVoice`
`timeline`	array	Day-by-day entries with `date` (ISO date string) and `mentionRate`

Filter by model

Pass ?model=GPT4O_MINI to scope the metrics to a single LLM. Model values correspond to the enum in lib/models.ts (e.g. GPT4O_MINI, CLAUDE_HAIKU, GEMINI_PRO).

curl "https://mentova.ai/api/v1/brands/clxabc123/visibility?days=7&model=GPT4O_MINI" \
  -H "X-API-Key: mtv_live_your_key"