extension

Get Brand Reputation

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:

{
  "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}
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

Path parameters

brand_namestring required

Query parameters

ai_platformstring nullable

Filter by AI platform

daysinteger

Number of days of data to include

Cookies

access_tokenstring nullable

Response

Successful Response

brand_namestring required

Brand name

reputation_scoreinteger required

Overall reputation score (0-100)

total_mentionsinteger required

Total brand mentions across all platforms

avg_ranknumber required

Average mention position across platforms

explicit_recommendationsinteger required

Total explicit recommendations

click_through_ratenumber required

Overall click-through rate

platformsobject required

Per-platform reputation breakdown

last_updatedstring date-time required

When score was last calculated

data_period_daysinteger

Number of days of data included

Example response

{
  "avg_rank": 1.8,
  "brand_name": "HubSpot",
  "click_through_rate": 0.34,
  "data_period_days": 30,
  "explicit_recommendations": 12456,
  "last_updated": "2025-10-29T10:30:00Z",
  "platforms": {
    "chatgpt": {
      "avg_rank": 1.5,
      "click_through_rate": 0.36,
      "explicit_recommendations": 6587,
      "mentions": 8234,
      "score": 94
    },
    "gemini": {
      "avg_rank": 2.1,
      "click_through_rate": 0.32,
      "explicit_recommendations": 3289,
      "mentions": 4123,
      "score": 91
    }
  },
  "reputation_score": 92,
  "total_mentions": 15234
}

Changes

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