Overzicht
Concurrenten zijn merken die samen met uw merk voorkomen in LLM-antwoorden. Mentova detecteert en volgt ze automatisch tijdens campagne-uitvoeringen. Het endpoint voor concurrenten geeft de volledige ranglijst terug, met vermeldingspercentages en co-occurrencegegevens.
Endpoints
| Methode | Pad | Beschrijving |
|---|---|---|
GET | /brands/{brandId}/competitors | Concurrenten met details weergeven |
GET | /brands/{brandId}/opportunities | Zichtbaarheidskansen weergeven |
PATCH | /brands/{brandId}/opportunities/{opportunityId} | Status van een kans wijzigen |
GET /brands//competitors
Geeft alle voor een merk gedetecteerde concurrenten terug, met hun vermeldingspercentages en co-occurrencegegevens.
curl https://mentova.ai/api/v1/brands/clxabc123/competitors \
-H "X-API-Key: mtv_live_votre_cle"
Antwoord 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
}
]
}
Antwoordvelden
| Veld | Type | Beschrijving |
|---|---|---|
id | string | ID van het concurrent-item |
name | string | Naam van de concurrent zoals geëxtraheerd uit de LLM-antwoorden |
domain | string | null | Bijbehorend domein, indien bekend |
mentionRate | number | Percentage LLM-antwoorden dat deze concurrent vermeldt |
coOccurrenceRate | number | Percentage antwoorden waarin deze concurrent samen met uw merk voorkomt |
rank | integer | Positie in de ranglijst (1 = meest vermeld) |
Kansen
Kansen zijn zichtbaarheidskloven die Mentova detecteert - thema's of contexten waarin concurrenten wel voorkomen, maar uw merk niet. Gebruik ze om uw content- of acquisitie-acties te prioriteren.
GET /brands//opportunities
Queryparameters
| Parameter | Type | Beschrijving |
|---|---|---|
status | string | Filteren op status: TODO, DONE of DISMISSED |
curl "https://mentova.ai/api/v1/brands/clxabc123/opportunities?status=TODO" \
-H "X-API-Key: mtv_live_votre_cle"
Antwoord 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/
Wijzigt de status van een kans.
Aanvraagbody
| Veld | Type | Verplicht | Beschrijving |
|---|---|---|---|
status | string | Ja | Nieuwe status: TODO, DONE of 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"}'
Antwoord 200
{
"data": {
"id": "clxopp1",
"status": "DONE"
}
}