Rankings

Measure how a set of brands rank in AI answers: mention rate, average position, and a per-model breakdown.

Overview

Track how often each model mentions a brand for a query, in what position, and the per-model split. mentionRate is the fraction of queried models whose answer named the brand; avgPosition is the mean 1-based rank of its first mention.

Reference

POST/v1/rankings

$0.07/model · billed per model queried, so all 5 models = $0.35. Pass models to query fewer.

Parameters

`query`required	string	The query to measure brand/competitor visibility on.
`competitors`required	string[]	Brand or domain names to track within the AI-generated answers.
`models`optional	array of enum (chatgpt \| claude \| perplexity \| gemini \| google_ai_overview)	Models to query. Defaults to all.

Request

curl https://api.cite42.dev/v1/rankings \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "best CRM for SaaS", "competitors": ["attio", "hubspot"] }'

Response

{
  "query": "best CRM for SaaS",
  "rankings": [
    {
      "competitor": "hubspot",
      "mentionRate": 0.92,
      "avgPosition": 1.4,
      "byModel": { "chatgpt": 1, "claude": 1, "perplexity": 2, "gemini": 1 }
    }
  ],
  "requestId": "…",
  "billing": { "cost": { "usd": "0.28" }, "balance": { "usd": "14.40" } }
}