Compare

Side-by-side rankings for your brand vs. up to 10 competitors, plus a co-mention graph.

Overview

Like /v1/rankings but for one primary brand against a competitor set, with a coMentions graph: for each pair of brands, how many model answers name both, surfacing who AI frames you alongside.

Reference

POST/v1/compare

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

Parameters

`query`required	string	The query to compare the brand and competitors on.
`brand`required	string	Your brand — ranked alongside the competitors.
`competitors`required	string[]	Competitor brand/domain names (up to 10) to rank against your brand.
`models`optional	array of enum (chatgpt \| claude \| perplexity \| gemini \| google_ai_overview)	Optional model subset. Omit to query all five AI surfaces (chatgpt, claude, perplexity, gemini, google_ai_overview). Pass ["perplexity"] or ["perplexity","claude"] when the user asks for specific surfaces or wants to reduce cost.

Request

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

Response

{
  "query": "best CRM for SaaS",
  "brand": "attio",
  "rankings": [
    {
      "competitor": "attio",
      "mentionRate": 0.6,
      "avgPosition": 2,
      "byModel": {
        "chatgpt": 2,
        "claude": 2,
        "perplexity": 2
      }
    },
    {
      "competitor": "hubspot",
      "mentionRate": 0.8,
      "avgPosition": 1,
      "byModel": {
        "chatgpt": 1,
        "claude": 1,
        "perplexity": 1,
        "gemini": 1
      }
    }
  ],
  "coMentions": [
    {
      "a": "attio",
      "b": "hubspot",
      "count": 2
    }
  ],
  "requestId": "…",
  "billing": {
    "cost": {
      "microCredits": 22000,
      "usd": "0.22"
    },
    "balance": {
      "microCredits": 1336000,
      "usd": "13.36"
    }
  }
}