---
title: "Get Competitive Scores"
method: GET
path: "/api/v1/scores/competitive"
tags: ["Analytics"]
---

# Get Competitive Scores

`GET /api/v1/scores/competitive`

## Request

- Base URL: `https://geo.sig.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://geo.sig.ai/api/v1/scores/competitive`
- Auth: HTTP bearer

Get competitive heatmap comparing brand vs competitors across models.

Aggregates visibility scores for user's brand and all competitors,
broken down by AI model (ChatGPT, Gemini, Perplexity, Grok, Claude).

Args:
    period: Time period (7days, 30days, 90days)
    brand_id: Optional brand ID to filter by (defaults to account's first brand)
    account: Current authenticated account
    db: Database session

Returns:
    List of CompetitiveBrandScore with per-model scores and averages

## Query parameters

- `period` '7days' | '30days' | '90days': Time period options for analytics queries. Standardized across all endpoints to ensure consistent date range calculations.
- `brand_id` string, uuid, nullable: Filter by specific brand ID

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- CompetitiveBrandScore[]
  - `brand` string, required
  - `brand_id` string, required
  - `is_user_brand` boolean, required
  - `scores` object, required: Model scores keyed by model name (chatgpt, gemini, claude, perplexity, grok)
  - `avg` number, required: Average score across all models

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api.md) · [All operations](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/revisions/3ec39f9be9e0?raw)