Visibilité

Vue d'ensemble

L'endpoint de visibilité renvoie trois métriques complémentaires calculées à partir de toutes les exécutions de campagne d'une marque :

SOV (share of voice) - pourcentage des mentions totales de chaque marque dans les réponses LLM
Taux de mention - taux de mention propre de la marque (0-100 %)
Timeline - taux de mention jour par jour sur la période sélectionnée

Endpoints

Méthode	Chemin	Description
`GET`	`/brands/{brandId}/visibility`	SOV, taux de mention et timeline

GET /brands//visibility

Paramètres de requête

Paramètre	Type	Défaut	Description
`days`	integer	`30`	Nombre de jours à analyser
`model`	string	-	Filtrer les résultats sur un modèle LLM spécifique (valeur d'enum)

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

Réponse `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
      }
    ]
  }
}

Champs de la réponse

Champ	Type	Description
`mentionRate`	number	Taux de mention de la marque en pourcentage (0-100)
`sov`	array	Classement share of voice. Chaque entrée contient `name`, `mentionRate` et `shareOfVoice`
`timeline`	array	Entrées jour par jour avec `date` (chaîne de date ISO) et `mentionRate`

Filtrer par modèle

Passez ?model=GPT4O_MINI pour limiter les métriques à un seul LLM. Les valeurs correspondent à l'enum dans lib/models.ts (ex. 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"