Brand Rankings

import httpx, os

resp = httpx.get(
    "https://api.aiclicks.io/api/v1/brand-rankings",
    params={
        "domain_id": "8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3",
        "days": 30,
    },
    headers={"Authorization": f"Bearer {os.environ['AICLICKS_API_KEY']}"},
)
resp.raise_for_status()
for row in resp.json()["data"]["items"]:
    pos = row["avg_position"] if row["avg_position"] is not None else "n/a"
    print(f"{row['name']:<20} mentions={row['mentions']:>4}  "
          f"visibility={row['visibility']:>5.2f}%  sov={row['sov']:>5.2f}%  pos={pos}")

const url = new URL("https://api.aiclicks.io/api/v1/brand-rankings");
url.searchParams.set("domain_id", "8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3");
url.searchParams.set("days", "30");

const resp = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.AICLICKS_API_KEY}` },
});
const { data } = await resp.json();
for (const row of data.items) {
  const pos = row.avg_position ?? "n/a";
  console.log(`${row.name}: mentions=${row.mentions} visibility=${row.visibility}% sov=${row.sov}% pos=${pos}`);
}

{
  "detail": "domain_id query parameter is required. List the domains this key can access with GET /api/v1/domains, then pass ?domain_id=<uuid>."
}

{
  "detail": "Invalid or revoked API key"
}

{
  "detail": "API access is not enabled for this team. Contact support@aiclicks.io."
}

{
  "detail": "Domain not found"
}

{
  "detail": "Too many requests. Please try again later."
}