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

# Real-Time Live Traffic

> Watch clicks arrive on your short links as they happen — second by second, in real time.

## What is Live Traffic Monitoring?

Live Traffic is a real-time click stream for any of your short links. Using **Server-Sent Events (SSE)**, TyrionURL pushes each click to your browser the moment it's recorded — no page refreshes required.

This is especially useful during active promotions, product launches, or live broadcasts when you want to see immediate audience response.

***

## When to Use Live Traffic

* **Product launches** — Monitor the spike as your announcement goes live
* **Live events** — See real-time engagement as you mention a link on stage or in a stream
* **Email sends** — Watch the initial wave of clicks the moment your campaign lands
* **Paid ad activation** — Confirm traffic is flowing as soon as an ad goes live
* **Troubleshooting** — Verify a link is working correctly by watching for your own test click

***

## Accessing Live Traffic

<Steps>
  <Step title="Open Link Analytics">
    From your dashboard, click the **Analytics** icon on the link you want to monitor.
  </Step>

  <Step title="Switch to the Live Tab">
    In the analytics view, click the **Live** tab at the top of the page.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/docs-tyrionurl/images/live-traffic-tab.png" alt="Live traffic tab in analytics view" />
    </Frame>
  </Step>

  <Step title="Watch the Feed">
    Each click appears in real time as a row in the live feed, showing:

    * Timestamp
    * Country/city of origin
    * Device type
    * Referrer (when available)

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/docs-tyrionurl/images/live-traffic-feed.png" alt="Live traffic event feed" />
    </Frame>
  </Step>
</Steps>

***

## How It Works (Technical)

Live traffic is powered by the Server-Sent Events (SSE) protocol. When you open the Live tab, your browser establishes a persistent connection to:

```
GET /api/analytics/live/:shortCode
```

The server pushes an event to this connection each time a click is recorded for the given short code. The browser updates the live feed without requiring a page reload or polling.

<Info>
  SSE connections remain open for as long as the Live tab is active. Navigating away closes the connection. Your historical analytics data is unaffected.
</Info>

***

## Live Feed Event Data

Each event in the live feed includes:

| Field        | Example         |
| ------------ | --------------- |
| **Time**     | `14:32:07`      |
| **Location** | `Mumbai, India` |
| **Device**   | `Mobile — iOS`  |
| **Browser**  | `Safari`        |
| **Referrer** | `instagram.com` |

***

## Best Practices

<Check>Open the Live tab a few minutes *before* your campaign goes live so you're ready when the first clicks arrive.</Check>
<Check>Keep the browser tab open and avoid navigating away during active monitoring — the SSE connection closes when you leave the page.</Check>
<Check>Use Live traffic alongside your email send platform's real-time open stats for a combined view of engagement.</Check>

***

## Common Mistakes

<Warning>
  **Monitoring a link that hasn't been distributed yet** — The live feed is empty until someone clicks the link. Confirm your link is published before monitoring.
</Warning>

<Warning>
  **Closing the tab and expecting data to buffer** — SSE is a live stream, not a recording. Clicks that occurred while the tab was closed are only visible in the standard analytics view (not the live feed).
</Warning>

***

## Related Pages

<CardGroup cols={2}>
  <Card title="Analytics Dashboard" icon="chart-line" href="/analytics/overview">
    Historical click data, charts, and device breakdowns.
  </Card>

  <Card title="Geo Heatmaps" icon="map" href="/analytics/geo-heatmaps">
    Visualize where in the world your clicks are coming from.
  </Card>
</CardGroup>