> ## Documentation Index
> Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Source Domain Analytics

> Deep-dive analytics for a single cited root domain, showing its citation trend plus breakdowns by URL, prompt, response, and (for YouTube) creator/timestamp data.

<Card title="Open in AthenaHQ" icon="arrow-up-right-from-square" href="https://app.athenahq.ai/sources" horizontal>
  `app.athenahq.ai/sources`
</Card>

## Purpose

The Source Domain Analytics page provides a deep-dive investigation into a single root domain that AI models are citing as a source. When you notice a specific domain driving traffic or appearing frequently in your main Sources list, this page helps you understand exactly *why* it ranks.

It breaks down the domain's performance across multiple dimensions: showing the overarching citation trend, exactly which individual URLs on that domain are being cited, which prompts trigger those citations, and what the AI models actually said in their responses. For YouTube domains, it goes a step further by breaking down citations by individual creators and tracking specific video timestamps.

## What's on the page

### Page Header

A top navigation bar displaying a breadcrumb link back to the main Sources list, alongside the root domain name. The domain name acts as a clickable link that opens the live website in a new tab. Note: This header is hidden when you are viewing the analytics page embedded inside a slide-out drawer.

### Contextual Filter Row

A sticky bar of filters allowing you to narrow down the data shown on the page. It includes filters for Date range, Models, Prompts, Personas, Locations, Prompt Tags, Prompt Status, and Source Mentions (Brand and Competitor). It also includes a Saved Views dropdown for saving or loading specific filter combinations.

### Citation Rate Over Time (Overview band)

A collapsible card near the top of the page. By default, it shows a quick summary of the domain's latest citation rate. When expanded, it reveals a full trend chart:

* **Citation Rate Over Time Chart**: A line/area chart with a gradient fill showing the trend of how often this domain is cited across responses over the selected date range. The X-axis represents the date, and the Y-axis is the citation percentage. Hovering over the chart displays a tooltip with the specific date, citation %, and the raw ratio (citations / total responses).

### Lens Tabs + Toolbar

A segmented control to switch between different data views: **URLs**, **Prompts**, **Responses**, and (if looking at a YouTube domain) **Creators** and **Timestamps**. To the right of the tabs sits an inline search box to filter the active view, and a Download icon button to export the data.

### URL Breakdown Table (URLs Tab)

Lists every specific URL under this root domain that AI models have cited.

* **(checkbox)**: Row selection for bulk actions like rescanning.
* **URL**: The cited page URL. For YouTube videos, this attempts to show the video title. If multiple variants of the same YouTube video are cited (e.g., standard links, timestamped links, mobile links), they collapse into a single canonical row with an expand toggle `>` to view the raw variants. Hovering reveals a mini chart icon for a 'View Analytics' shortcut.
* **Source Mentions Brand**: Indicates whether your brand is mentioned on this URL's page. Displays N/A with a retry button if the page couldn't be successfully scraped. Tooltip: *"Whether your brand is mentioned in sources from this URL"*
* **Source Mentions Competitor**: Shows which tracked competitors are mentioned on this URL's page. Tooltip: *"Competitors mentioned in sources from this URL"*
* **First Seen**: The date this URL was first observed as a citation.
* **Citation %**: The percent of all responses (in your filtered period) that cite this specific URL.
* **Domain %**: The percent of this domain's total citations that this specific URL accounts for.
* **Citations**: The raw count of responses citing this URL.
* **Actions**: A row-level ⋯ (three dots) menu containing a Rescan action.

### Prompt Breakdown Table (Prompts Tab)

Groups the prompts driving traffic to this domain by Topic.

* **Prompt**: Displays the Topic name on parent rows (which can be expanded). Child rows show the individual prompt text.
* **Tags**: Shows the prompt's type badge (Branded or Non-branded) alongside any custom prompt tags. You can click here to edit the tags.
* **Citation %**: The percent of responses to this prompt (or the topic's average) that cited this domain.
* **Citations**: The number of citations of this domain resulting from this prompt (or the topic total).

### Responses Table (Responses Tab)

Shows the standard Responses table, but filtered exclusively to AI responses that cited this root domain.

* **(Shared Columns)**: This displays the exact same columns as the main Responses page (Date, Model, Prompt, Citation/Mention flags, Competitors, Sources, etc.).

### YouTube Creator Breakdown Table (Creators Tab)

*Only visible when analyzing a `youtube.com` or `youtu.be` domain.* Groups video citations by the YouTube channel/creator.

* **Creator**: The YouTube channel or author name. Links out to the channel if the URL is known. Clicking the row expands it to show the creator's videos.
* **Total Citations**: The sum of citations across all of this creator's videos. Tooltip: *"Total number of citations across all videos from this creator"*
* **Avg Citation %**: The average citation percentage across the creator's videos. Tooltip: *"Average citation percentage across all videos"*
* **Videos**: The count of distinct videos from this creator.

**Expanded video sub-table** (Visible when clicking a Creator row):

* **Video**: The video title or path, including a 'View Analytics' shortcut icon.
* **Citations**: The citation count for this specific video.
* **Citation %**: The citation percentage for this specific video.
* **First Seen**: The date this video was first cited.

### Timestamped YouTube Sources (Timestamps Tab)

*Only visible when analyzing a YouTube domain.* Lists individual YouTube citations that include a specific timestamp.

* **Timestamped YouTube Citations by Model** (Chart): A horizontal stacked bar chart showing the breakdown of YouTube citation links by whether they include a timestamp parameter, segmented by AI model.
* **URLs with Timestamps** (Chart): A donut chart showing the overall share of unique YouTube URLs that include a timestamp parameter.
* **YouTube title** (Table Column): Title of the cited video, which links out to YouTube and includes a 'View Analytics' shortcut.
* **Prompt** (Table Column): The prompt text that produced this citation.
* **Timestamp** (Table Column): The actual `t=` parameter value extracted from the URL (e.g., `t=30`), or `—` if none exists.
* **Citations** (Table Column): The number of citations for this row.
* **Citation %** (Table Column): The citation percentage for this row.

### Export Dialog

A modal that appears when you click the Download icon, allowing you to select how many rows to export to CSV, complete with +/- adjusters, quick-select amounts, and an "Export all" option.

## What you can do here

* **Back to Sources**: Click the back arrow in the header to return to the main Sources list.
* **Open root domain in new tab**: Click the domain name in the header to open the live site in a new browser tab.
* **Switch lens tab**: Click the URLs, Prompts, Responses, Creators, or Timestamps tabs to change the active breakdown. The selected tab is saved in your URL, so it persists if you refresh or navigate back.
* **Search within active lens**: Type into the search box located in the tab toolbar. This filters the data in the currently active tab. (Note: Search terms reset when you switch tabs).
* **Download / Export**: Click the download icon in the toolbar. Depending on the active tab, this either opens the Export dialog to select row limits or triggers an inline CSV download (for Responses). This requires your subscription plan to include data exports.
* **Expand/Collapse Citation Rate Over Time trend**: Click anywhere on the trend card's header or chevron to toggle between the summary text and the full line chart.
* **Sort table column**: Click any sortable column header to reorder the table's rows ascending or descending.
* **Expand/Collapse YouTube video variants**: On the URLs tab (for YouTube domains), click the small chevron next to a canonical video URL to reveal the raw, individual variant URLs (like mobile links or timestamped links) collapsed underneath it.
* **View Analytics**: Hover over a URL, Timestamp row, or expanded Creator video row to reveal a mini chart icon. Clicking it opens a deep-dive analytics drawer for that specific URL. You can also Cmd/Ctrl-click it to open the analytics in a new browser tab.
* **Toggle row checkbox**: In the URLs tab, click the checkbox on any row to select it for bulk actions. You can hold `Shift` and click another checkbox to select or deselect a large range of rows at once.
* **Select all rows**: Click the master checkbox in the URLs table header to select or deselect all visible rows.
* **Rescan URL**: In the URLs tab, click the ⋯ (three dots) menu on the far right of a row and select **Rescan**. This triggers a fresh scrape to check for brand and competitor mentions.
* **Bulk Rescan**: After selecting multiple rows in the URLs tab, a floating command bar appears at the bottom of the screen. Click **Rescan** to scrape all selected URLs (up to 1,000) at once. This action requires write-level analytics permissions. There is no confirmation prompt; it fires immediately and reports success via a toast notification.
* **Clear selection**: In the bulk action command bar, click **Clear** or press the `Esc` key on your keyboard to deselect all rows.
* **Set tags / Edit tags**: In the Prompts tab, click the gray "Set tags" button or click on any existing tag badge on a prompt row to open the Edit Prompt Tags dialog. Here you can assign the Branded/Non-branded type and attach custom tags.
* **Expand/Collapse topic group**: In the Prompts tab, click the chevron on a Topic parent row to show or hide the specific prompts grouped underneath it. You can also click the chevron in the column header to expand or collapse all topics at once.
* **Expand/Collapse creator group**: In the Creators tab, click the chevron on a Creator row to show or hide their individual videos. The header chevron expands/collapses all creators.
* **Load More**: Scroll to the bottom of the URLs, Timestamps, or Prompts tables and click the **Load More** button (or just keep scrolling) to fetch the next page of rows.
* **Adjust filters**: Use the top contextual filter row to apply Date range, Models, Prompts, Personas, Locations, Prompt Tags, Prompt Status, Source Mentions Brand, and Source Mentions Competitor filters. Updating these refreshes all tables and the trend chart.
* **Save / Load view**: Open the saved-views dropdown in the filter bar to persist your current filter combination as a named view, or to load a previously saved one.
* **Reset filters (Clear All)**: If you have active filters, click the orange "Clear All" button to revert the page to its default state.
* **Export dialog actions**: Once the export modal is open, use the `+` / `-` buttons, the quick-select presets, or the "Export all" button to adjust how many rows your CSV will contain. Finally, click **Export** to start the download.

## Data shown

This page displays data from the AI responses your workspace tracks, specifically scoped to the domain you are investigating. It surfaces the specific URLs (the sources) cited by the AI, cross-referenced with your tracked competitors, your configured prompt library, and your tags. For YouTube domains, it additionally pulls in channel and video metadata via YouTube to attribute citations to specific creators and exact video timestamps. Filter selections you've saved or recently used are also loaded here.

## Common workflows

**Investigate why a domain is being cited**

1. Land on the domain analytics page by clicking a domain in your main Sources table.
2. Review the Citation Rate Over Time trend card, expanding it to see if the domain is spiking or consistently cited.
3. Switch to the Prompts tab to identify exactly which topics and prompts are triggering the AI to cite this domain.
4. Switch to the Responses tab to read the raw AI responses and see the context in which the domain was recommended.

**Audit and rescan stale URL data**

1. Open the URLs tab.
2. Open your filters and set "Source Mentions Brand" to "N/A" to isolate pages the system previously failed to scrape.
3. Select one or more rows using the checkboxes (use Shift-click for a large range).
4. In the floating command bar that appears, click the Rescan action to force the system to re-check those pages for your brand and your competitors.

**Export cited URLs for offline analysis**

1. Open the URLs tab and apply any necessary filters or search terms.
2. Click the download icon in the right side of the toolbar.
3. In the Export dialog, adjust the number of rows you need or click "Export all".
4. Click Export to generate and download the CSV file.

**Analyze YouTube citation patterns**

1. Open the analytics page for a YouTube root domain.
2. Switch to the Creators tab to discover which specific YouTube channels generate the most citations for your tracked prompts.
3. Expand a top creator to view their most-cited individual videos.
4. Switch to the Timestamps tab to investigate whether the AI is linking to specific moments in those videos, and check the charts to see which AI models rely on timestamps the most.

**Tag and classify prompts driving citations**

1. Open the Prompts tab to view the prompts generating citations for this domain.
2. Click "Set tags" (or click an existing badge) on a specific prompt row.
3. In the dialog, classify the prompt as Branded or Non-branded, and create or apply custom tags.
4. Save your changes, which immediately refreshes the Prompt Breakdown table with your new classifications.

## Empty, loading, and error states

* **Empty**: If no data matches your criteria, the tables will display a message based on the tab, such as *"No citation data found for this period"* (URLs tab), *"No prompt data found for this period"* (Prompts tab), or *"No YouTube videos found for this source"* (Creators tab). If you are using the search box, it will read *"No URLs match '\<search>'"*.
* **Loading**: While data is being fetched, an animated loader is shown in place of the chart or table content.
* **Error**: General API failures fail silently and typically result in an empty state. If an export fails, a red toast notification will appear in the corner with the error message.

## Linked from / links to

* **Linked from**: You usually arrive here from the main **Sources** table by clicking a domain row or its 'View Analytics' icon. It can also be accessed whenever the Source drawer is opened elsewhere in the app (like from the Responses table).
* **Links to**: The Back button takes you to the main `/sources` page. Clicking a row's analytics icon opens the deep-dive URL analytics drawer/page (`/sources/analytics/<url>`). The header domain name and table URLs link out to the live, external websites.

## Common support questions

**Why don't I see the Creators and Timestamps tabs?**
The Creators and Timestamps tabs are heavily customized for video content and only appear when you are viewing analytics for `youtube.com` or `youtu.be`.

**Why does the bulk rescan button look disabled?**
While viewing analytics is available to all users, triggering a bulk rescan consumes system resources and rewrites data. It requires write-level analytics permissions. If you only have view permissions, the action will be disabled.

**Why did my export only download 1,000 URLs?**
The URL Breakdown table and its associated bulk actions have a hard cap of 1,000 rows. If your filter criteria yield more than 1,000 URLs, you will see a message reading *"Load limit reached. Refine filters to view more."* You must adjust your filters to narrow the list before exporting.

**Why is "N/A" showing for brand mentions?**
An "N/A" badge means the system attempted to scrape the page to check for brand or competitor mentions, but the scrape failed (e.g., the page blocked our bot, or it was taken down). You can click the menu on that row to try rescanning it.

**Why does the citation trend chart look different from my URLs table when I select N/A?**
The "Source Mentions Brand" filter's N/A option is specifically designed for the URLs tab. The Citation Rate trend chart relies on percentage math that cannot factor in "unknown" states, so the chart intentionally strips out the N/A filter.