traffic.live
See active visitors on your site now. Get visitor count, top pages, referrers, and countries from the last 5 minutes (adjustable up to 60).
Instructions
See who is on the site in the last N minutes. Returns the active visitor count plus top pages, top referrers, and top countries within that window. Defaults to 5 minutes; max 60. Use during incidents ("is anyone hitting the broken page right now"), launches ("is the new post getting traffic"), or whenever the user asks "who is on the site".
Examples:
"who is on the site right now" → window_minutes=5
"has anyone visited in the last hour" → window_minutes=60
"is the launch page getting hits" → window_minutes=15
Limitations: ingestion lag is ~30 seconds, so "live" is approximate. Visitor count is unique anonymous_ids in the window, not active sessions. For historical questions ("who visited last week"), use traffic.overview instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | No | Target project ID (e.g. "proj_abc123"). Required when the credential has access to multiple projects. If omitted and only one project is accessible, that project is used automatically. Call `projects.list` to discover available project IDs. | |
| window_minutes | No | Lookback window in minutes. Defaults to 5, max 60. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| window_minutes | Yes | ||
| visitors | Yes | ||
| pageviews | Yes | ||
| top_pages | Yes | ||
| top_sources | Yes | ||
| top_countries | Yes |