Live

Ubiquiti UniFi WiFi Analytics

Unlock guest intelligence from your UniFi network

Get Started API Docs

60sRefresh Rate

~180KData Points/Day

<150msNormalization

10API Fields

How It Works

Ubiquiti UniFi to AI in three steps

The Problem

UniFi's controller shows connected clients but doesn't expose behavioral analytics. Your access points collect rich session data that stays locked in the controller database.

The Solution

Client session tracking with bandwidth and duration metrics
AP-level performance monitoring and health scoring
Guest vs. employee network segmentation analytics
Historical trend analysis across all UniFi sites
Works with UniFi Cloud, self-hosted, and Dream Machine

Data Explorer

What Data You Get from Ubiquiti UniFi

Every field below is normalized into the GuestNetworks canonical schema and available via REST API and MCP tools.

Field Name ↑	Type	Description	Example
ap_name	string	Access point friendly name	UAP-AC-Pro-Lobby
channel	number	WiFi channel number	36
essid	string	Connected SSID name	Corporate-WiFi
hostname	string	Client device hostname	iPhone-Guest
mac	string	Client MAC address	ab:cd:ef:12:34:56
radio	string	Radio band (2G/5G/6G)	5G
rx_bytes	number	Total bytes received	1073741824
signal	number	Signal strength in dBm	-38
tx_bytes	number	Total bytes transmitted	524288000
uptime	number	Client connection uptime in seconds	7200

Live Preview

This is what your AI agent sees

Every Ubiquiti UniFi event is normalized into this canonical JSON structure. One schema, any connector.

gn_canonical_event.json

{
  "event_type": "wifi_presence",
  "connector": "unifi",
  "venue_id": "ven_4x9m1p",
  "timestamp": "2024-03-22T14:30:00.000Z",
  "data": {
    "client_mac_pseudo": "f1e2d3c4b5a6",
    "signal": -38,
    "ssid": "Corporate-WiFi",
    "ap_name": "UAP-AC-Pro-Lobby",
    "channel": 36,
    "tx_bytes": 524288000,
    "rx_bytes": 1073741824,
    "uptime_seconds": 7200
  },
  "metadata": {
    "normalized_at": "2024-03-22T14:30:00.023Z",
    "schema_version": "1.0",
    "encryption": "AES-256-GCM"
  }
}

Data Types

What You Get

WiFi presenceclient sessionsbandwidth usageAP stats

Visualizations

Built-in Chart Types

Every integration unlocks these dashboard visualizations. No configuration needed.

Client Session Trends

Connected clients over time across all APs and sites

AP Utilization Heatmap

Visual map of client distribution across access points

Signal Quality Analysis

Signal strength distribution showing coverage quality

Session Duration Histogram

How long guests stay connected per visit

Quick Start

Get your Ubiquiti UniFi data in 60 seconds

Four steps from zero to live data. Your credentials are encrypted with AES-256-GCM at rest.

Get UniFi controller credentials

Create a local admin account on your UniFi Controller or UniFi Cloud instance with read-only access.

Create a GuestNetworks account

curl -X POST https://api.guestnetworks.com/api/operators \
  -H "X-Admin-Key: $ADMIN_KEY"

Register UniFi integration

POST your controller URL and credentials. They are encrypted with AES-256-GCM.

curl -X POST https://api.guestnetworks.com/api/venues/:id/integrations \
  -d '{"connector_type": "unifi", "config": {"controller_url": "https://unifi.local:8443", "username": "...", "password": "..."}}'