POST /v1/check · mode reference

mode:perplexity_live

Live capture of Perplexity's UI rendering for a query. Returns the full answer text, 5–10 inline citations, and 3–5 "related searches" fan-out queries — the data product real users see, not the API summary.

When to use it

  • You need ground-truth — what an actual Perplexity user would see for the query.
  • You need the inline citation graph (URLs Perplexity attributes the answer to).
  • You need the fan-out queries Perplexity surfaces under "Related" — useful for keyword research and detecting query expansion.

Pricing

$0.25 per call. Single-platform mode — no fan-out across providers. On upstream failure (rate-limit, profile expired, etc.) the refund is 100% — you don't pay for failed scrapes.

SLA

Target 95% success rate, <30s p95 latency. Live UI capture is inherently more variable than API-side mode:quick.

Request

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

Response

json
{
  "id": "chk_a8d2c...",
  "mode": "perplexity_live",
  "providers": {
    "perplexity": {
      "mentioned": true,
      "rank": 6,
      "context": "If you want a free-tier and strong sales/marketing features: HubSpot CRM (free plan; scales with paid add-ons). Great for startups...",
      "citations": [
        { "url": "https://zapier.com/blog/best-crms-for-small-business/", "title": "The 12 best CRMs for small business - Zapier" },
        { "url": "https://www.softwareadvice.com/crm/", "title": "CRM Software Reviews" },
        { "url": "https://www.g2.com/categories/crm", "title": "G2 CRM" }
      ],
      "fan_out": [
        "What features matter most for my small business CRM",
        "CRM comparisons by price for small businesses in 2026",
        "Top CRM for startups with limited budgets",
        "CRM vs ERP: what does a small business need",
        "Reviews of popular small business CRMs this year"
      ]
    }
  },
  "duration_ms": 25102,
  "cost_cents": 25,
  "cache_hit": false
}

Notes

  • Citation freshness: we surface URLs verbatim as Perplexity returns them. Some may be stale or reflect the platform's snapshot — we don't validate URL reachability.
  • Fan-out: populated from Perplexity's "Related" panel. Sub-queries are usually plausible refinements, not LLM-imagined.
  • Region: use the region field to pin geo-IP routing (us | uk | ca | au).