# Overview

## Performance Hub

**Available on: Solo plans and higher**

Track your brand's organic search performance, content health, social engagement, and AI visibility in one unified dashboard. The Performance Hub aggregates data from 7 sources so you can see what is working, what is decaying, and where the opportunities are.

***

### What You Can Do

* **Monitor organic traffic** from Google Search Console (clicks, impressions, CTR, rankings)
* **Track content health** with page-level grades, decay detection, and optimization signals
* **Measure social engagement** across all connected platforms (impressions, clicks, engagements)
* **See AI visibility** to find out if ChatGPT and Google AI Overview cite your brand
* **Identify quick wins** like striking distance keywords and underperforming titles
* **Detect content cannibalization** where multiple pages compete for the same keyword
* **Track your Brand Visibility Score** over time as a single north star metric

***

### Plan Requirements

| Tab           | Solo | Studio | Scale | Enterprise |
| ------------- | ---- | ------ | ----- | ---------- |
| Overview      | ✅    | ✅      | ✅     | ✅          |
| Pages         | ✅    | ✅      | ✅     | ✅          |
| Social        | ✅    | ✅      | ✅     | ✅          |
| AI Visibility | ❌    | ✅      | ✅     | ✅          |

> **Upgrade to Studio** to unlock AI Visibility and see if LLMs like ChatGPT and Google AI Overview are citing your brand.

***

### Data Sources

The Performance Hub pulls from up to 7 external data sources depending on what you have connected:

| Source                    | What It Provides                                                     | Sync Frequency            |
| ------------------------- | -------------------------------------------------------------------- | ------------------------- |
| **Google Search Console** | Clicks, impressions, CTR, keyword rankings, page positions           | Daily (4 AM UTC)          |
| **Google Analytics 4**    | Sessions, pageviews, engagement metrics                              | Daily (5 AM UTC)          |
| **Ahrefs**                | Domain rating, backlinks, referring domains, Brand Radar             | On-demand                 |
| **Late.dev**              | Social analytics across all connected platforms                      | Daily (7 AM UTC)          |
| **Firehose**              | Web mentions, brand monitoring across the internet                   | Every 30 minutes          |
| **DataForSEO**            | LLM citations (ChatGPT, Google AI Overview), competitor intelligence | Weekly or daily (by plan) |
| **LLM Tracking**          | Which AI models cite your brand and for which prompts                | Weekly or daily (by plan) |

> **Note**: GSC data has a 2-3 day natural delay from Google. This is a Google limitation, not a Cuppa limitation.

***

### Overview Tab

The Overview tab gives you a high-level snapshot of your brand's performance.

#### KPIs

* **Organic Clicks**: Total clicks from Google Search in the selected period
* **Organic Impressions**: Total impressions in Google Search results
* **Average CTR**: Click-through rate across all your keywords
* **Average Position**: Mean ranking position across tracked keywords
* **Brand Visibility Score**: A composite metric tracking your overall brand visibility

#### Trends

Interactive charts showing organic traffic, social engagement, and content health over time. Toggle between 7-day, 30-day, 90-day, and 365-day views.

#### Quick Wins

The Overview automatically surfaces:

* **Striking distance keywords**: Ranking positions 4-20 where a small push could land you on page 1
* **CTR opportunities**: High-impression, low-click keywords where title optimization could help
* **Content decay**: Pages losing traffic over the past 90 days that need refreshing
* **Cannibalization**: Multiple pages competing for the same keyword

#### Top Pages and Queries

See your best-performing pages and queries at a glance, sorted by clicks, impressions, or CTR.

***

### Pages Tab

**Available on: Solo plans and higher**

Page-level performance data combining GSC rankings, content grades, and GA4 engagement.

#### What You See

| Column        | Description                 |
| ------------- | --------------------------- |
| Page URL      | The indexed page            |
| Clicks        | Organic clicks from GSC     |
| Impressions   | Search impressions          |
| CTR           | Click-through rate          |
| Avg Position  | Mean ranking position       |
| Content Grade | SEO grade (if graded)       |
| Sessions      | GA4 sessions (if connected) |
| Status        | Active, declining, or new   |

#### Page Detail

Click any page to see:

* **Keyword breakdown**: Every keyword driving traffic to that page
* **Position history**: How rankings changed over time (sparklines)
* **Content grade details**: SEO, readability, AI search, structure, slop, technical scores
* **Optimization suggestions**: AI-powered recommendations based on SERP competitors

#### Content Decay Detection

Pages are flagged as "declining" when their clicks or impressions drop significantly over a 90-day window. Use the Optimization tools to refresh stale content.

***

### Social Tab

**Available on: Solo plans and higher**

Social media performance across all platforms connected through Late.dev.

#### Metrics Tracked

* **Impressions**: Total views of your social posts
* **Engagements**: Likes, comments, shares, reposts
* **Clicks**: Link clicks on social posts
* **Posts Published**: Count of published posts in the period

#### Platform Breakdown

See performance per platform (LinkedIn, X, Instagram, Facebook, TikTok, YouTube, Pinterest, Bluesky, Threads) to understand where your audience engages most.

#### Connecting Social Accounts

Social analytics require a Late.dev integration. Go to **Team Settings > Integrations** and connect your social platforms through Late.dev.

***

### AI Visibility Tab

**Available on: Studio plans and higher**

Track whether AI systems like ChatGPT and Google AI Overview cite your brand.

#### Why AI Visibility Matters

When users ask ChatGPT "what is the best tool for X?" or Google shows an AI Overview, your brand may or may not appear. AI Visibility tracks this so you can take action.

#### What You See

* **Total AI Citations**: How many times your brand is cited by LLMs
* **ChatGPT vs Google AI Overview**: Breakdown by platform
* **Top Prompts**: Which user prompts trigger citations of your brand
* **Top Cited Pages**: Which of your pages get cited most
* **Citation Gaps**: Prompts where competitors are cited but you are not
* **Competitor Comparison**: Side-by-side AI mention counts vs competitors

#### Citation Gaps

This is one of the most actionable views. It shows prompts where competitors appear in AI responses but your brand does not. Use this to:

1. Create content targeting those specific topics
2. Add relevant information to your Knowledge Base
3. Build authority in the areas where LLMs are not yet aware of you

#### Competitor Management

Add up to 3 competitors (unlimited on Enterprise) to track relative AI visibility. The hub monitors how often each competitor is cited versus your brand.

#### LLM Sync Frequency

| Plan       | Sync Frequency |
| ---------- | -------------- |
| Studio     | Every 7 days   |
| Scale      | Every 7 days   |
| Enterprise | Daily          |

***

### Brand Visibility Score

The Brand Visibility Score (BVS) is a composite metric that combines:

* **Organic search performance** (GSC clicks, impressions, rankings)
* **Content quality** (average content grades)
* **AI citations** (LLM mention counts)
* **Social reach** (impressions and engagements)
* **Domain authority** (Ahrefs DR, if connected)

#### How to Interpret BVS

| Score Range | Meaning                                 |
| ----------- | --------------------------------------- |
| 0-20        | Early stage, just getting started       |
| 21-40       | Building foundation, initial traction   |
| 41-60       | Growing visibility, content is working  |
| 61-80       | Strong brand presence, well-established |
| 81-100      | Market leader in your niche             |

#### Weekly Digest

Every Monday at 7 AM UTC, Cuppa calculates your BVS and sends a performance digest notification with:

* Current BVS and trend direction
* Top-performing content from the past week
* Pages that need attention
* Quick wins to act on

***

### Annotations

Add annotations to your performance timeline to track events that impact your metrics:

* Content launches
* Algorithm updates (Google core updates are pre-seeded)
* Site migrations
* Link building campaigns
* Social campaigns

Annotations help you correlate ranking changes with specific actions.

***

### Backlinks

**Requires Ahrefs API connection**

View your backlink profile within the Performance Hub:

* **Domain Rating**: Your site's overall authority
* **Referring Domains**: Number of unique domains linking to you
* **Total Backlinks**: Total link count
* **Top Referring Domains**: Sorted by DR

***

### Web Mentions

**Requires Firehose connection**

Track brand mentions across the web:

* **Mention count**: Total mentions in the period
* **Sentiment**: Positive, negative, neutral breakdown
* **Source domains**: Where mentions come from
* **Actions**: Mark as read, flag for follow-up, or dismiss

***

### API and Agent Access

The Performance Hub is fully accessible via the MCP server, CLI, and REST API.

#### MCP / CLI Tools

| Tool                    | What It Does                                      |
| ----------------------- | ------------------------------------------------- |
| `get_brand_performance` | Overview KPIs, BVS, quick wins, top pages/queries |
| `get_content_health`    | Page-level performance data with grades           |
| `get_ai_visibility`     | LLM citations, prompts, gaps (Studio+)            |
| `get_backlinks`         | Domain rating, referring domains, backlink data   |

#### REST API Endpoints

| Endpoint                         | Method | Plan    |
| -------------------------------- | ------ | ------- |
| `/v1/performance/overview`       | GET    | Solo+   |
| `/v1/performance/content-health` | GET    | Solo+   |
| `/v1/performance/ai-visibility`  | GET    | Studio+ |
| `/v1/performance/backlinks`      | GET    | Solo+   |

#### Agent Workflow Example

Your AI agent can use Performance Hub data to drive content decisions:

1. **Pull performance data**: "Check my brand performance for the last 30 days"
2. **Identify gaps**: The agent sees declining pages and striking distance keywords
3. **Create content**: Generates articles targeting the highest-value opportunities
4. **Optimize**: Grades and optimizes content until it outscores competitors
5. **Distribute**: Publishes to CMS and generates social posts
6. **Monitor**: Checks back in a week to measure the impact

***

### Troubleshooting

#### "No data showing"

* Verify GSC is connected (Team Settings > Integrations)
* Wait 24 hours after connecting for the first sync
* GSC data has a 2-3 day delay from Google

#### "Social tab is empty"

* Connect social accounts through Late.dev (Team Settings > Integrations)
* Publish at least one social post through Cuppa
* Wait for the daily sync (7 AM UTC)

#### "AI Visibility shows zero citations"

* This is normal for newer or smaller brands
* LLMs may not yet be aware of your content
* Focus on building topical authority through Knowledge Bases and high-quality content
* AI Visibility data syncs weekly (Studio/Scale) or daily (Enterprise)

#### "Brand Visibility Score seems low"

* BVS is a composite score. Check which components are weakest
* Connect all available data sources for the most accurate score
* Early-stage brands typically score 10-30

***

### FAQ

**Do I need all data sources connected?** No. The Performance Hub works with whatever data sources you have connected. More connections mean more complete data.

**How often does data refresh?** GSC and GA4 sync daily. Social analytics sync daily. Web mentions sync every 30 minutes. LLM data syncs weekly or daily depending on plan.

**Can I export performance data?** Use the API or CLI to pull data programmatically. The MCP tools return structured data your AI agent can process.

**Does the Performance Hub affect my content?** No. The hub is read-only. It monitors and reports but never modifies your content or rankings.

**What is the Brand Visibility Score?** A composite metric (0-100) combining organic search, content quality, AI citations, social reach, and domain authority. It is your single north star for brand visibility.

**Why is AI Visibility only on Studio+?** AI Visibility requires LLM tracking data from DataForSEO, which has per-query API costs. Studio plans and above include this data.

***

### Related Docs

* Google Search Console -- Connect GSC for organic data
* Ahrefs Integration -- Connect for backlink and DR data
* Social Media -- Connect social accounts
* Agent Brand Engineering -- Use Performance Hub data with AI agents
* Content Planner -- Plan content based on performance insights