Get Visibility Comparison

Compare visibility scores and rankings between your brand and competitors.

GET /ai-analytics-service/api/public/v1/analytics/visibility-comparison

Get Visibility Comparison

cURL

curl --request GET \
  --url https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/visibility-comparison \
  --header 'Authorization: <authorization>'

200

{
  "data": [
    {
      "name": "<string>",
      "score": 123,
      "color": "<string>",
      "type": "<string>",
      "rank": 123,
      "change": "<string>"
    }
  ]
}

Returns a ranked comparison of visibility scores for your brand and competitors. Use this to understand where your brand stands relative to the competition in AI search results.

Parameters

Authorization · string · required

Bearer token. Format: Bearer slat_<your-token>.

dateRange · integer · required

Number of days for the analysis window (e.g., 7, 30, 90).

topicId · number

Filter by topic ID.

platform · string[]

Filter by one or more platforms: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

Response

Returns 200 OK with an array of visibility comparison objects, ranked by score.

data · object[] · required

Array of visibility comparison objects.

Show visibility comparison object

name · string · required

Brand or competitor name.

score · number · required

Visibility score.

color · string · required

Display color for the entity (hex code).

type · string · required

One of: BRAND, COMPETITOR.

rank · integer · required

Position in the ranking (1 = highest visibility).

change · string · required

Change in score compared to the previous period (e.g., +5, -2).

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/visibility-comparison?dateRange=30&topicId=42" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

[
  {
    "name": "MyBrand",
    "score": 85,
    "color": "#4F46E5",
    "type": "BRAND",
    "rank": 1,
    "change": "+5"
  },
  {
    "name": "CompetitorA",
    "score": 70,
    "color": "#EF4444",
    "type": "COMPETITOR",
    "rank": 2,
    "change": "-2"
  },
  {
    "name": "CompetitorB",
    "score": 55,
    "color": "#F59E0B",
    "type": "COMPETITOR",
    "rank": 3,
    "change": "+1"
  }
]

Status codes

Status	Description
200	Visibility comparison returned.
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Share of Voice — Compare share of voice percentages.
• Get Citations — View citation sources in AI responses.