Analytics

Get Visibility Score

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

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

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

a_sovinteger required

Answer Share-of-Voice (0-100)

recommendedness_indexinteger required

Recommendation Index (0-100)

citedness_pctnumber required

Citation rate percentage (0-100)

drift_index_pctnumber required

Period-over-period change (-100 to +100)

time_to_fix_daysnumber nullable

Median days to fix issues

overall_scoreinteger required

DEPRECATED: Use a_sov instead

changeinteger required

DEPRECATED: Use drift_index_pct instead

visibility_ratenumber required

DEPRECATED: Use citedness_pct instead

avg_ranknumber required
recommendation_strengthnumber required

DEPRECATED: Use recommendedness_index instead

sentimentnumber required
queries_mentionedinteger required
total_queriesinteger required
periodobject required

Changes

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