---
title: "Get Insights"
method: GET
path: "/api/v1/scores/insights"
tags: ["Analytics"]
---

# Get Insights

`GET /api/v1/scores/insights`

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

Get actionable insights by analyzing judge results and trends.

Generates 3 priority insights across categories:
- Performance trends (improving/declining visibility)
- Competitive positioning (rank, mentions vs competitors)
- Opportunities (models/queries to focus on)

Args:
    type: Insight type (currently only 'overview' supported)
    brand_id: Optional brand ID to filter by (defaults to account's first brand)
    account: Current authenticated account
    db: Database session

Returns:
    List of 3 insight objects with title, description, variant, icon

## Query parameters

- `type` string
- `brand_id` string, uuid, nullable: Filter by specific brand ID

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- unknown

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