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

# Get Realtime Report

> Live Google Analytics 4 activity from the last 30 minutes (60 on GA4 360): active users, events, key events and views right now, by country, city, device, page or screen, event or minute

Live Google Analytics 4 activity from the last 30 minutes (60 on GA4 360): active users, events, key events and views right now, by country, city, device, page or screen, event or minute. One property per run. Use ga4\_get\_report for anything older than 30 minutes.

| | |
| - | - |
| **App** | GA4 |
| **Operation ID** | `ga4_get_realtime_report` |
| **Type** | Action |
| **Connection** | `ga4` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | array (also accepts a comma-separated string) | No | - | The GA4 property to read. Only one property at a time. |
| `metrics` | string or array of string | No | - | Realtime metrics, default \['activeUsers']. Options: activeUsers, eventCount, keyEvents, screenPageViews. |
| `dimensions` | string or array of string | No | - | Realtime dimensions; none (the default) returns property totals. Options: country, countryId, city, cityId, deviceCategory, platform, appVersion, unifiedScreenName (page title or app screen name), eventName, minutesAgo (one row per minute, '00' is the current minute), audienceId, audienceName, audienceResourceName, streamId, streamName, or a user-scoped custom dimension as 'customUser:\<parameter\_name>'. Event-scoped custom dimensions are not available in realtime reports. |
| `start_minutes_ago` | integer | No | - | Start of the window, in minutes before now. Default 29, the full 30 minutes Google keeps for standard properties (up to 59 on GA4 360). |
| `end_minutes_ago` | integer | No | - | End of the window, in minutes before now. Default 0 (now). Example: start 4 and end 0 cover the last 5 minutes. |
| `filters` | array of FilterItem | No | - | Filters on the realtime metrics and dimensions above, combined with AND, e.g. \[\{'field': 'unifiedScreenName', 'operator': 'CONTAINS', 'value': 'Checkout'}]. |
| `orders` | array of OrderItem | No | - | Sort order, default the first metric descending. Use minutesAgo ASC for a minute-by-minute timeline. |
| `limit` | integer | No | - | Maximum rows to return, default 10,000, up to 250,000. |

### FilterItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `field` | string or SelectableOption | Yes | - | The field to filter on, must be one of the current selected metrics or dimensions. |
| `operator` | string | Yes | - | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*' |
| `value` | string | Yes | - | The value to filter by, always as a string: text, a number, or a regex. For IN\_LIST and NOT\_IN\_LIST, pass the values as one comma-separated string such as 'a,b,c', not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b. |

### OrderItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `field` | string or SelectableOption | Yes | - | The field to sort by. must be one of the current selected metrics or dimensions. |
| `direction` | string | Yes | - | The order to sort by, must be one of 'ASC', 'DESC' |

### SelectableOption

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |

## Output

**Type**: `List[Dict]`

Returns one row per dimension combination with the requested metrics as numbers; with no dimensions, one row of property totals. minutesAgo values are two-digit strings ('00' is the current minute).

**Fields**: dynamic (depend on the inputs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.