Analytics

Get Competitive Scores

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

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

Query parameters

period'7days' | '30days' | '90days'

Time period options for analytics queries.

Standardized across all endpoints to ensure consistent date range calculations.

Time period for analysis

brand_idstring uuid nullable

Filter by specific brand ID

Cookies

access_tokenstring nullable

Response

Successful Response

brandstring required
brand_idstring required
is_user_brandboolean required
scoresobject required

Model scores keyed by model name (chatgpt, gemini, claude, perplexity, grok)

avgnumber required

Average score across all models

Example response

[
  {
    "scores": {
      "chatgpt": 85,
      "claude": 92,
      "gemini": 78,
      "grok": 73,
      "perplexity": 67
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.