Get visibility

curl https://corecited.com/api/v1/brands/7d1c2b9e-4a3f-4e61-9b2a-0c5d8e7f6a14/visibility \
  -H "Authorization: Bearer $CORECITED_API_KEY"

// Node 18+ (global fetch). Run server-side: the key must never reach a browser.
const res = await fetch("https://corecited.com/api/v1/brands/7d1c2b9e-4a3f-4e61-9b2a-0c5d8e7f6a14/visibility", {
  headers: { Authorization: `Bearer ${process.env.CORECITED_API_KEY}` },
});

const body = await res.json();
if (!res.ok) {
  // Branch on body.error.code, never on the message text.
  throw new Error(`${res.status} ${body.error.code}: ${body.error.message}`);
}

const { data } = body;
console.log(data);

import os
import requests

res = requests.get(
    "https://corecited.com/api/v1/brands/7d1c2b9e-4a3f-4e61-9b2a-0c5d8e7f6a14/visibility",
    headers={"Authorization": f"Bearer {os.environ['CORECITED_API_KEY']}"},
    timeout=30,
)

body = res.json()
if not res.ok:
    # Branch on body["error"]["code"], never on the message text.
    raise RuntimeError(f"{res.status_code} {body['error']['code']}: {body['error']['message']}")

data = body["data"]
print(data)

{
  "data": {
    "brand": {
      "id": "7d1c2b9e-4a3f-4e61-9b2a-0c5d8e7f6a14",
      "name": "Acme Resume",
      "domain": "https://www.acmeresume.com/"
    },
    "overallVisibility": 44,
    "perEngine": [
      {
        "slug": "chatgpt",
        "isWebGrounded": false,
        "score": 58,
        "date": "2026-09-21",
        "bandLow": 31.2,
        "bandHigh": 52.8,
        "isSignificant": true,
        "isWarmingUp": false,
        "noAnswerRate": null
      },
      {
        "slug": "ai_overview",
        "isWebGrounded": true,
        "score": 30,
        "date": "2026-09-21",
        "bandLow": null,
        "bandHigh": null,
        "isSignificant": false,
        "isWarmingUp": true,
        "noAnswerRate": 40
      }
    ],
    "trend": {
      "chatgpt": [
        {
          "date": "2026-09-14",
          "score": 40
        },
        {
          "date": "2026-09-21",
          "score": 58
        }
      ],
      "ai_overview": [
        {
          "date": "2026-09-21",
          "score": 30
        }
      ]
    },
    "alerts": [
      {
        "slug": "chatgpt",
        "score": 58
      }
    ],
    "signals": {
      "netSentiment": 53,
      "positive": 9,
      "neutral": 5,
      "negative": 1,
      "avgPosition": 2.4,
      "mentions": 15
    }
  }
}