---
title: "Get Brand Reputation"
method: GET
path: "/api/v1/extension/reputation/{brand_name}"
tags: ["extension"]
---

# Get Brand Reputation

`GET /api/v1/extension/reputation/{brand_name}`

## 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/extension/reputation/{brand_name}`
- Auth: HTTP bearer

Get brand reputation score.

Calculates reputation score (0-100) based on:
- Total mentions across AI platforms
- Average mention rank (lower = better)
- Explicit recommendations count
- Click-through rate

**Path Parameters:**
- `brand_name`: Brand name to query

**Query Parameters:**
- `ai_platform` (optional): Filter by specific platform ('chatgpt', 'gemini', 'claude', 'perplexity')
- `days` (optional): Number of days of data (default: 30, max: 365)

**Response:**
```json
{
  "brand_name": "HubSpot",
  "reputation_score": 92,
  "total_mentions": 15234,
  "avg_rank": 1.8,
  "platforms": {
    "chatgpt": {"score": 94, "mentions": 8234, ...},
    "gemini": {"score": 91, "mentions": 4123, ...}
  }
}
```

**Caching:**
- Cached in Redis for 5 minutes
- Cache key: `extension:reputation:{brand_name}:{platform}:{days}`

## Path parameters

- `brand_name` string, required

## Query parameters

- `ai_platform` string, nullable: Filter by AI platform
- `days` integer: Number of days of data to include

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- BrandReputationResponse: Schema for brand reputation score response. Aggregates reputation metrics across all AI platforms.
  - `brand_name` string, required: Brand name
  - `reputation_score` integer, required: Overall reputation score (0-100)
  - `total_mentions` integer, required: Total brand mentions across all platforms
  - `avg_rank` number, required: Average mention position across platforms
  - `explicit_recommendations` integer, required: Total explicit recommendations
  - `click_through_rate` number, required: Overall click-through rate
  - `platforms` object, required: Per-platform reputation breakdown
  - `last_updated` string, date-time, required: When score was last calculated
  - `data_period_days` integer: Number of days of data included

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