Competitive share of voice

Compute the head-to-head between two brands across a query portfolio. Use /v1/compare for the per-query winner + delta_pct, then aggregate to a share-of-voice dashboard.

Why it matters

GEO competitive analysis is the new SEO competitive analysis — every brand wants to know whether they're winning the AI-search visibility race against their top competitor. /v1/compare gives you the per-query verdict (winner: brand_a | brand_b | tie) and a numeric delta so you can plot the gap over time.

Code

bash

curl https://api.mentionsapi.com/v1/compare \
  -H "Authorization: Bearer lvk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best CRM for small business",
    "brand_a": "HubSpot",
    "brand_b": "Salesforce"
  }'

Pricing

/v1/compare is $1.50 per call (it fans out to mode:quick for both brands). At 4 queries × $1.50 = $6.00 for a complete weekly competitive snapshot.