Rankings

Measure how a set of brands rank in AI answers (mention rate, average position, and a per-model breakdown) from your agent.

Overview

Give your agent a query and a set of brands; it returns how often each model names each brand, in what position, and the per-model split: the raw signal for tracking AI visibility.

Example

Ask your agent in plain English and it calls the tool for you:

# you say
How do Acme CRM, Rival CRM, and Legacy CRM rank in ChatGPT and Claude for “best startup CRM”?

The tool returns structured JSON to your agent (you never see this directly):

{
  "query": "best startup CRM",
  "rankings": [
    { "competitor": "Rival CRM", "mentionRate": 0.92, "avgPosition": 1.4 },
    { "competitor": "Acme CRM", "mentionRate": 0.71, "avgPosition": 2.1 }
  ],
  "billing": { "cost": { "usd": "0.20" } }
}

Your agent reads that JSON and answers you in plain English. That reply is written by your own AI; the JSON is just what it reasons over:

# your AI replies
Rival CRM leads: named in 92% of answers, almost always first (avg. position 1.4).
Acme CRM shows up in 71%, usually 2nd. Legacy CRM barely registers. To move up, focus on the prompts where Acme CRM is mentioned but ranked below Rival CRM.

Full input and output schema: POST /v1/rankings. For AI-model tools, pass an optional models list to narrow which models run (see per-model pricing).