---
title: "Get Brand Visibility"
method: GET
path: "/api/b2b/visibility/{brand_id}"
tags: ["b2b-visibility"]
---

# Get Brand Visibility

`GET /api/b2b/visibility/{brand_id}`

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

Get brand visibility metrics for a specified date range.

**Visibility Score (0-100):**
Composite score based on:
- **Mention Frequency (40%)**: How often the brand is mentioned
- **Position Quality (30%)**: How highly ranked in AI responses
- **Engagement (20%)**: How often users interact with mentions
- **Sentiment (10%)**: Overall sentiment of mentions

**Trend Analysis:**
Compares current period to previous period of equal length to determine
if visibility is growing, stable, or declining.

**AI Source Breakdown:**
Metrics broken down by platform (ChatGPT, Claude, Gemini, etc.)

**Daily Breakdown:**
Time-series data for each day in the requested period

**Example Request:**
```
GET /api/b2b/visibility/550e8400-e29b-41d4-a716-446655440000?start_date=2026-01-01&end_date=2026-01-31
```

**Example Response:**
```json
{
    "brand_id": "550e8400-e29b-41d4-a716-446655440000",
    "brand_name": "OpenAI",
    "period": {
        "start": "2026-01-01",
        "end": "2026-01-31"
    },
    "visibility_score": {
        "mention_frequency": 75.5,
        "position_quality": 85.0,
        "engagement": 42.3,
        "sentiment": 78.9,
        "overall": 72.4
    },
    "trend": "growing",
    "trend_pct_change": 15.3,
    "by_ai_source": {
        "chatgpt": {
            "mention_count": 1250,
            "avg_position": 2.3,
            "engagement_rate": 0.42
        },
        "claude": {
            "mention_count": 980,
            "avg_position": 1.8,
            "engagement_rate": 0.45
        }
    },
    "industry_benchmark": {
        "avg_visibility_score": 50.0,
        "avg_mention_count": 100,
        "avg_engagement_rate": 0.25
    },
    "daily_breakdown": [
        {
            "date": "2026-01-01",
            "mentions": 45,
            "impressions": 60,
            "avg_position": 2.5,
            "engagement_rate": 0.40
        }
    ]
}
```

**Requirements:**
- Authentication required (B2B subscription)
- Date range must be valid (end_date >= start_date)
- Maximum date range: 365 days

## Path parameters

- `brand_id` string, uuid, nullable, required

## Query parameters

- `start_date` string, date, required: Start date (inclusive)
- `end_date` string, date, required: End date (inclusive)
- `ai_sources` AISource[], nullable: Filter by AI sources (e.g., chatgpt, claude, gemini)

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- BrandVisibilityResponse: Response for brand visibility metrics.
  - `brand_id` string, uuid, required
  - `brand_name` string, required
  - `period` object, required: {'start': date, 'end': date}
  - `visibility_score` VisibilityScoreBreakdown, required: Visibility score components.
    - `mention_frequency` number, required: Frequency score (0-100)
    - `position_quality` number, required: Position score (0-100)
    - `engagement` number, required: Engagement score (0-100)
    - `sentiment` number, required: Sentiment score (0-100)
    - `overall` number, required: Overall visibility score
  - `trend` string, required: 'growing', 'stable', or 'declining'
  - `trend_pct_change` number, required: % change vs previous period
  - `by_ai_source` object, required
  - `industry_benchmark` object, required: Industry averages
  - `daily_breakdown` DailyVisibilityData[], required
    - `date` string, date, required
    - `mentions` integer, required
    - `impressions` integer, required
    - `avg_position` number, required
    - `engagement_rate` number, required

## Other responses

- `404`: Brand not found
- `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)