Zichtbaarheid

Overzicht

Het zichtbaarheids-endpoint geeft drie aanvullende statistieken terug, berekend over alle campagne-uitvoeringen van een merk:

SOV (share of voice) - percentage van het totaal aantal vermeldingen per merk in de LLM-antwoorden
Vermeldingspercentage - eigen vermeldingspercentage van het merk (0-100%)
Tijdlijn - vermeldingspercentage per dag over de geselecteerde periode

Endpoints

Methode	Pad	Beschrijving
`GET`	`/brands/{brandId}/visibility`	SOV, vermeldingspercentage en tijdlijn

GET /brands//visibility

Queryparameters

Parameter	Type	Standaard	Beschrijving
`days`	integer	`30`	Aantal te analyseren dagen
`model`	string	-	Resultaten filteren op een specifiek LLM-model (enum-waarde)

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

Antwoord `200`

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

Antwoordvelden

Veld	Type	Beschrijving
`mentionRate`	number	Vermeldingspercentage van het merk (0-100)
`sov`	array	Share of voice-ranglijst. Elk item bevat `name`, `mentionRate` en `shareOfVoice`
`timeline`	array	Dagelijkse items met `date` (ISO-datumstring) en `mentionRate`

Filteren op model

Geef ?model=GPT4O_MINI mee om de statistieken tot één LLM te beperken. De waarden komen overeen met de enum in lib/models.ts (bijv. 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_votre_cle"