Run a Google Analytics realtime report
run_realtime_reportRead-onlyIdempotent
Use this when the user asks what is happening on their site or app right now: active users in the last 30 minutes, optionally by country, city, device, platform, page or screen ('unifiedScreenName') or event name. Default metric activeUsers; eventCount, screenPageViews and keyEvents are also available. Standard properties cover the last 30 minutes, GA4 360 properties 60. Realtime figures are preliminary and never cached. Read-only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filters | No | All filters are combined with AND. A filter on a requested metric is numeric (equals, notEquals, greaterThan, greaterThanOrEqual, lessThan, lessThanOrEqual with a number value); any other field is a dimension filter with a string operator. | |
| metrics | No | Realtime metric API names. Default activeUsers. | |
| order_by | No | ||
| row_limit | No | Rows to return. Default 20, maximum 100. | |
| dimensions | No | Realtime dimension API names, e.g. 'country', 'city', 'deviceCategory', 'platform', 'unifiedScreenName', 'eventName', 'minutesAgo'. | |
| minutes_ago | No | How many minutes back to cover, up to now. Default 29 (the last 30 minutes). | |
| property_id | Yes | Exact property ID from list_properties, e.g. 'properties/123456789'. | |
| connection_id | No | Optional: force a specific Google connection when the property is visible to several. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | No | ||
| units | No | ||
| totals | No | ||
| request | No | ||
| coverage | No | ||
| property | No | ||
| freshness | No | ||
| requestId | No |