Read audience breakdown
get_google_analytics_audience_breakdownSessions and engagement split by device, country, or new versus returning visitors, optionally compared with the previous period. Organic Search by default. Read only and free.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "get_google_analytics_audience_breakdown"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| device | No | Only this device: desktop, mobile or tablet. | |
| medium | No | Only sessions whose medium contains this text, in any case. | |
| offset | No | ||
| source | No | Only sessions whose source contains this text, in any case. | |
| channel | No | Which traffic to read: Organic Search only (default) or all. | organic_search |
| country | No | Only this country, as its two-letter ISO code, for example DE. | |
| endDate | No | Inclusive date as YYYY-MM-DD. Give both startDate and endDate, or neither for the last 28 complete property days. | |
| campaign | No | Only sessions whose campaign contains this text, in any case. | |
| keyEvent | No | Count only this key event (for example purchase) in the key event columns, instead of all key events. Not for the key events report, which lists them by name. | |
| breakdown | No | How to split the audience. | device |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| startDate | No | Inclusive date as YYYY-MM-DD. Give both startDate and endDate, or neither for the last 28 complete property days. | |
| channelGroup | No | Only this Google default channel group by its exact name, for example Paid Search, Organic Social or AI Assistant. Pass channel=all where the tool has it, or Organic Search is all that is read. | |
| pageContains | No | Only pages whose address contains this text, in any case. Not for site search or ecommerce by item. | |
| comparePreviousPeriod | No | Also read the period just before and compare the rows. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | No | ||
| error | No | ||
| quota | No | ||
| source | No | ||
| status | Yes | ||
| request | No | ||
| pageInfo | No | ||
| rowCount | No | ||
| warnings | No | ||
| comparison | No | ||
| diagnostics | No | ||
| totalRowCount | No | ||
| reportMetadata | No | ||
| ecommerceActivity | No | ||
| diagnosticCoverage | No | ||
| siteSearchActivity | No |