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.07/model · billed per model queried, so all 5 models = $0.35. 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)	Models to query. Defaults to all.

Request

curl https://api.cite42.dev/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": [ /* brand first, then each competitor, same shape as /v1/rankings */ ],
  "coMentions": [
    { "a": "attio", "b": "hubspot", "count": 2 }
  ],
  "requestId": "…",
  "billing": { "cost": { "usd": "0.28" }, "balance": { "usd": "14.12" } }
}