Vue d'ensemble

Les concurrents sont des marques qui apparaissent dans les réponses LLM aux côtés de votre marque. Mentova les détecte et les suit automatiquement lors des exécutions de campagnes. L'endpoint concurrents renvoie le classement complet avec les taux de mention et les données de co-occurrence.

Endpoints

MéthodeCheminDescription
GET/brands/{brandId}/competitorsLister les concurrents avec détails
GET/brands/{brandId}/opportunitiesLister les opportunités de visibilité
PATCH/brands/{brandId}/opportunities/{opportunityId}Modifier le statut d'une opportunité

GET /brands//competitors

Renvoie tous les concurrents détectés pour une marque, avec leurs taux de mention et leurs données de co-occurrence.

curl https://mentova.ai/api/v1/brands/clxabc123/competitors \
  -H "X-API-Key: mtv_live_votre_cle"

Réponse 200

{
  "data": [
    {
      "id": "clxcomp1",
      "name": "Rival SA",
      "domain": "rival.com",
      "mentionRate": 31.0,
      "coOccurrenceRate": 18.5,
      "rank": 1
    },
    {
      "id": "clxcomp2",
      "name": "Autre Outil",
      "domain": null,
      "mentionRate": 22.4,
      "coOccurrenceRate": 12.1,
      "rank": 2
    }
  ]
}

Champs de la réponse

ChampTypeDescription
idstringIdentifiant de l'entrée concurrent
namestringNom du concurrent tel qu'extrait des réponses LLM
domainstring | nullDomaine associé si connu
mentionRatenumberPourcentage des réponses LLM mentionnant ce concurrent
coOccurrenceRatenumberPourcentage des réponses où ce concurrent apparaît aux côtés de votre marque
rankintegerPosition dans le classement (1 = le plus mentionné)

Opportunités

Les opportunités sont des lacunes de visibilité détectées par Mentova - des sujets ou contextes où des concurrents apparaissent mais pas votre marque. Utilisez-les pour prioriser vos actions de contenu ou de prospection.

GET /brands//opportunities

Paramètres de requête

ParamètreTypeDescription
statusstringFiltrer par statut : TODO, DONE ou DISMISSED
curl "https://mentova.ai/api/v1/brands/clxabc123/opportunities?status=TODO" \
  -H "X-API-Key: mtv_live_votre_cle"

Réponse 200

{
  "data": [
    {
      "id": "clxopp1",
      "title": "Outils de productivité pour équipes distantes",
      "description": "Votre marque était absente dans 8 réponses où Rival SA était mentionnée.",
      "status": "TODO",
      "priorityScore": 87,
      "competitorsMentioned": ["Rival SA", "Autre Outil"],
      "createdAt": "2026-06-01T09:00:00.000Z"
    }
  ]
}

PATCH /brands//opportunities/

Modifie le statut d'une opportunité.

Corps de la requête

ChampTypeRequisDescription
statusstringOuiNouveau statut : TODO, DONE ou DISMISSED
curl -X PATCH \
  https://mentova.ai/api/v1/brands/clxabc123/opportunities/clxopp1 \
  -H "X-API-Key: mtv_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"status": "DONE"}'

Réponse 200

{
  "data": {
    "id": "clxopp1",
    "status": "DONE"
  }
}