POST /v1/check · mode reference

mode:chatgpt_live

Live capture of ChatGPT's UI answer. Surfaces three signals the official ChatGPT API doesn't expose: fan-out queries (the web-search expansions ChatGPT issues during reasoning), brand entities (the platform-recognized brand mentions in the answer), and inline citations.

Why fan-out + brand entities matter

When ChatGPT answers a brand-comparison query, it often runs 3–5 background web searches ("best free CRM 2026", "HubSpot vs Salesforce", etc.) before composing the response. Those searches are themselves brand-discovery moments — the queries surface as new intents to track. The brand-entity list captures every brand the platform recognized, so you know who you're being compared against. Neither signal is reachable through OpenAI's official API.

Pricing

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

SLA

Target 95% success rate, <30s p95 latency. Browser-based capture; latency tail can extend on heavily-loaded ChatGPT regions.

Request

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

Response

json
{
  "id": "chk_a8d2c...",
  "mode": "chatgpt_live",
  "providers": {
    "chatgpt": {
      "mentioned": true,
      "rank": 6,
      "context": "Among the top picks for small businesses, HubSpot CRM stands out for its free tier and strong marketing automation...",
      "citations": [
        { "url": "https://www.g2.com/categories/crm", "title": "G2 CRM Reviews" },
        { "url": "https://blog.hubspot.com/sales/crm-software", "title": "HubSpot CRM Software Guide" }
      ],
      "fan_out": [
        "best free CRM 2026",
        "HubSpot vs Salesforce small business",
        "CRM features startups need",
        "free CRM with marketing automation"
      ],
      "brand_entities": [
        { "name": "HubSpot", "domain": "hubspot.com", "description": "Free CRM with marketing/sales suite" },
        { "name": "Salesforce", "domain": "salesforce.com" },
        { "name": "Zoho CRM", "domain": "zoho.com" },
        { "name": "Pipedrive", "domain": "pipedrive.com" }
      ]
    }
  },
  "duration_ms": 22418,
  "cost_cents": 10,
  "cache_hit": false
}

Notes

  • fan_out may be empty for purely informational queries that don't trigger web search. Brand-comparison queries reliably trigger search.
  • brand_entities is best-effort — when the platform doesn't surface entity descriptors, the array is empty.
  • Use mode:all_live to run this scrape alongside the other 5 live surfaces in a single call.