POST /v1/check · mode reference

mode:ai_mode

Google's AI Mode — the new conversational AI search surface separate from Search and Gemini. Returns the markdown answer text and the inline citations the response cites.

When to use it

Tracking brand presence in Google's conversational AI search results.
Capturing the markdown formatting Google ships in AI Mode (different from Gemini and AIO).
Comparing AI Mode citations against the broader AI Overview reference graph.

Pricing

$0.10 per call. 100% refund on upstream failure.

SLA

Target 95% success rate, <8s p95 latency.

Request

bash

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

Response

json

{
  "id": "chk_a8d2c...",
  "mode": "ai_mode",
  "providers": {
    "ai_mode": {
      "mentioned": true, "rank": 2,
      "context": "**HubSpot CRM** offers a generous free tier — strong choice for small teams that want marketing automation without paying upfront...",
      "citations": [
        { "url": "https://www.hubspot.com/products/crm", "title": "HubSpot Products" },
        { "url": "https://blog.hubspot.com/sales/best-crm", "title": "Best CRM" }
      ],
      "fan_out": [],
      "brand_entities": []
    }
  },
  "duration_ms": 5803,
  "cost_cents": 10,
  "cache_hit": false
}