Developers

API & MCP

A read-only API to pull your brands, AI-search scores, buyer funnel and AI-referred traffic & revenue into your own dashboards, BI tools, and AI agents. Available on every paid plan — not gated to enterprise.

Authentication

Generate a key in Settings → API access. Pass it as a bearer token (or ?api_key=). Keys are read-only and scoped to your workspace.

Authorization: Bearer grk_xxxxxxxxxxxxxxxxxxxxxxxx

List brands

GET /api/v1/brands — every brand with its latest visibility.

curl -H "Authorization: Bearer grk_..." \
  https://app.genairanker.com/api/v1/brands

{
  "brands": [
    {
      "id": "…",
      "name": "Acme",
      "domain": "acme.com",
      "visibility_score": 61,
      "mention_rate": 0.42,
      "last_tracked": "2026-06-23"
    }
  ]
}

Brand detail

GET /api/v1/brands/:id— scores by engine, competitors, buyer funnel, AI traffic & revenue, revenue by topic, and the source domains AI trusts for your category (Citation Authority).

{
  "brand": { "id": "…", "name": "Acme", "domain": "acme.com" },
  "visibility": { "score": 61, "mention_rate": 0.42, "share_of_answer": 0.31, "answers_analyzed": 240 },
  "by_engine": [ { "engine": "openai", "score": 68, "mention_rate": 0.5 }, … ],
  "competitors": [ { "name": "Globex", "mentions": 84 }, … ],
  "competitor_sources": [ { "domain": "g2.com", "count": 12 }, … ],
  "funnel": [ { "stage": "awareness", "score": 55, "mention_rate": 0.4, "prompts": 12 }, … ],
  "ai_traffic": { "sessions": 1240, "conversions": 38, "revenue": 310000, "currency": "INR", "by_engine": [ … ] },
  "revenue_by_topic": { "currency": "INR", "total_revenue": 310000,
    "topics": [ { "topic": "Crm", "ai_visibility": 0.7, "sessions": 40, "revenue": 90000, "state": "money" }, … ] },
  "citation_authority": { "topics_matched": 6,
    "sources": [ { "domain": "g2.com", "reach": 9, "you_are_cited": false, "earn": true }, … ] }
}

Rate limits & format

600 requests/hour per key. All responses are JSON with permissive CORS, so you can call the API from a browser dashboard. Errors return a JSON { "error": "…" } with the appropriate status code.

MCP (Model Context Protocol)

We host a live MCP server so AI agents (Claude, etc.) can query your brands' AI-search visibility, buyer funnel and AI-referred revenue right in a conversation. JSON-RPC 2.0 over HTTP, authed by your API key. Tools:list_brands and get_brand.

{
  "mcpServers": {
    "genai-ranker": {
      "type": "http",
      "url": "https://app.genairanker.com/api/mcp",
      "headers": { "Authorization": "Bearer grk_..." }
    }
  }
}

Add that to your MCP client config and ask, e.g., “What’s my AI-search visibility for acme.com, and how much revenue did AI drive last month?”