Top values by dimension
get_breakdownTop values of one dimension for a date range, for visitors and for conversions - the same breakdowns as the Tagely analytics page. url: page views (excluding bots) grouped by URL without query string; conversions not available for url. utm / referer / country / device: visitor counts are new visitors' entry views; conversion counts are conversion events, attributed by the event's own UTMs (utm) or by the converting visitor's entry view (referer, country, device). Bots excluded. Device codes: D desktop, M mobile, T tablet.
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": {
"dimension": "<dimension>"
},
"name": "get_breakdown"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of top values, default 10 (20 for url). | |
| period | No | Date range. last_7_days / last_30_days end yesterday (today excluded), as on the Tagely analytics page. Default last_7_days, or custom if start_date is given. | |
| end_date | No | YYYY-MM-DD, for period=custom (inclusive). A custom range covers at most 366 days. | |
| dimension | Yes | ||
| start_date | No | YYYY-MM-DD, for period=custom (inclusive). |