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

35 credits 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": [],
      "sponsored": []
    }
  },
  "duration_ms": 5803,
  "cost_cents": 35,
  "cache_hit": false
}

Sponsored placements

AI Mode can embed paid blocks inside the answer. They are reported under sponsored as { advertiser, title, url, domain, rendered } (always present in this mode; empty when the answer carried no paid block; rendered is always true here because the block is part of the rendered answer). Paid blocks are kept out of the answer text and never count toward mentioned, rank or citations.

Availability

AI Mode hasn't launched in every region. If the surface isn't available in your requested region, the slot reports surface_unavailable_in_region under errors.ai_mode (the call still 200s; the failed platform is refunded). If AI Mode is available but showed no AI answer for this query, the slot returns surface_present: false with mentioned: false — distinct from "an answer existed but your brand wasn't in it".