POST /v1/check · mode reference

mode:gemini_live

Live capture of Gemini's UI answer. Returns the rendered answer, the "Related searches" fan-out, brand entities, and inline citations.

When to use it

Tracking brand presence across Google's conversational AI surface (separate from Search and AI Mode).
Capturing Gemini's "Related searches" expansions, which often differ from Google Search's "People also ask".

Pricing

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

SLA

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

Request

bash

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

Response

json

{
  "id": "chk_a8d2c...",
  "mode": "gemini_live",
  "providers": {
    "gemini": {
      "mentioned": true, "rank": 5,
      "context": "Looking at popular options, HubSpot's free CRM offers strong marketing tooling...",
      "citations": [
        { "url": "https://www.hubspot.com/products/crm", "title": "HubSpot CRM" },
        { "url": "https://www.salesforce.com/crm/", "title": "Salesforce CRM" }
      ],
      "fan_out": [
        "free crm comparison",
        "small business crm features",
        "hubspot pricing",
        "best crm for marketing teams"
      ],
      "brand_entities": [
        { "name": "HubSpot", "domain": "hubspot.com" },
        { "name": "Pipedrive", "domain": "pipedrive.com" }
      ]
    }
  },
  "duration_ms": 21002,
  "cost_cents": 10,
  "cache_hit": false
}