---
title: "Get Brand Metrics"
method: GET
path: "/api/v1/b2c/brands/{brand_id}/metrics"
tags: ["B2C Dashboard"]
---

# Get Brand Metrics

`GET /api/v1/b2c/brands/{brand_id}/metrics`

## 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/b2c/brands/{brand_id}/metrics`
- Auth: HTTP bearer

Get brand metrics for dashboard

Returns:
- Mention rate (% of answers mentioning brand)
- Recommendation strength (avg 0-1)
- Average position when mentioned
- Sentiment score (-1 to 1)
- Visibility score (0-100)
- Per-model breakdown
- Competitive advantages/disadvantages
- Trend direction and % change

## Path parameters

- `brand_id` string, required

## Query parameters

- `days_back` integer: Days back to analyze

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- BrandMetricsResponse: Complete brand metrics response
  - `brand_id` string, required
  - `brand_name` string, required
  - `vertical_name` string, required
  - `metrics` object, required: Primary metrics (mention_rate, recommendation_strength, etc)
  - `model_breakdown` ModelBreakdownResponse[], required: Per-model metrics
    - `model_name` string, required
    - `mention_rate` number, required
    - `recommendation_strength` number, required
    - `average_position` number, required
    - `sentiment_score` number, required
    - `total_mentions` integer, required
  - `competitive_advantages` string[], required
  - `competitive_disadvantages` string[], required
  - `primary_competitors` string[], required
  - `trend_direction` string, required
  - `trend_change_percent` number, required
  - `period_start` string, date-time, required
  - `period_end` string, date-time, required
  - `total_answers_analyzed` integer, 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)