---
title: "Get Visibility Score"
method: GET
path: "/api/v1/scores/visibility"
tags: ["Analytics"]
---

# Get Visibility Score

`GET /api/v1/scores/visibility`

## 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/visibility`
- Auth: HTTP bearer

Get current visibility score with PRD v4 metrics.

Returns both new wedge metrics (a_sov, recommendedness_index, etc.) and
legacy metrics for backward compatibility during transition.

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:
    VisibilityScoreResponse with PRD v4 wedge metrics + legacy fields

## 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

- VisibilityScoreResponse: Current visibility score response schema with PRD v4 metrics. Wedge Metrics (Primary KPIs): - a_sov: Answer Share-of-Voice (0-100) - Brand's visibility across AI models - recommendedness_index: Recommendation strength (0-100) - How strongly AI recommends the brand - citedness_pct: Citation rate (0-100%) - Percentage of answers citing authoritative sources - drift_index_pct: Period-over-period change (-100% to +100%) - Trend direction - time_to_fix_days: Median days to resolve visibility issues Legacy fields maintained for backward compatibility during transition.
  - `a_sov` integer, required: Answer Share-of-Voice (0-100)
  - `recommendedness_index` integer, required: Recommendation Index (0-100)
  - `citedness_pct` number, required: Citation rate percentage (0-100)
  - `drift_index_pct` number, required: Period-over-period change (-100 to +100)
  - `time_to_fix_days` number, nullable: Median days to fix issues
  - `overall_score` integer, required: DEPRECATED: Use a_sov instead
  - `change` integer, required: DEPRECATED: Use drift_index_pct instead
  - `visibility_rate` number, required: DEPRECATED: Use citedness_pct instead
  - `avg_rank` number, required
  - `recommendation_strength` number, required: DEPRECATED: Use recommendedness_index instead
  - `sentiment` number, required
  - `queries_mentioned` integer, required
  - `total_queries` integer, required
  - `period` object, required
  - `timeline` TimelineDataPoint[]: Daily scores for charting
    - `date` string, required
    - `score` integer, required
    - `chatgpt` integer, nullable, required
    - `gemini` integer, nullable, required
    - `claude` integer, nullable, required
    - `perplexity` integer, nullable, required
    - `grok` integer, nullable, required

## 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)