Overview

Competitors are brands that appear in LLM responses alongside your brand. Mentova automatically detects and tracks them across campaign runs. The competitors endpoint returns the full leaderboard with mention rates and context.

Endpoints

GET /brands//competitors

Returns all competitors detected for a brand, including their mention rates and co-occurrence data.

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

Response 200

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

Response fields

Opportunities

Opportunities are visibility gaps detected by Mentova - topics or contexts where competitors appear but your brand does not. Use them to prioritize content or outreach actions.

GET /brands//opportunities

Query parameters

curl "https://mentova.ai/api/v1/brands/clxabc123/opportunities?status=TODO" \
  -H "X-API-Key: mtv_live_your_key"

Response 200

{
  "data": [
    {
      "id": "clxopp1",
      "title": "Remote team productivity tools",
      "description": "Your brand was absent in 8 responses where Rival Inc was mentioned.",
      "status": "TODO",
      "priorityScore": 87,
      "competitorsMentioned": ["Rival Inc", "Other Tool"],
      "createdAt": "2026-06-01T09:00:00.000Z"
    }
  ]
}

PATCH /brands//opportunities/

Update the status of an opportunity.

Request body

curl -X PATCH \
  https://mentova.ai/api/v1/brands/clxabc123/opportunities/clxopp1 \
  -H "X-API-Key: mtv_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"status": "DONE"}'

Response 200

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