Get Time Series by Dimension
Sessions bucketed over time and split by a session dimension — one series per top value (by total sessions, unfolded, no server-side ‘Other’). Answers ‘how is each AI assistant / channel / country trending’ in one call. Session-mode dimensions only; no compare.
Authorizations
An API key created in your account settings, sent as Authorization: Bearer <key>.
Path Parameters
Site ID.
Query Parameters
Start of the range, as YYYY-MM-DD.
End of the range, as YYYY-MM-DD.
IANA time zone used to bucket the range, e.g. America/New_York.
"America/New_York"
JSON-encoded array of filter objects, each { dimension, op, value } where value is an array. Example: [{"dimension":"country","op":"equals","value":["US"]}]. A user-trait filter uses the templated dimension trait:<key> — [{"dimension":"trait:plan","op":"equals","value":["pro"]}] — and matches identified users only, by the trait's current value. Trait ops: equals, not_equals, contains, not_contains, starts_with, ends_with, is_null ("is not set"), is_not_null ("is set"); regex is not available. Trait filters require a member session or a users:read key, max 4 per query, and a filter matching more than 10,000 identified users fails with TRAIT_FILTER_TOO_BROAD.
The session dimension to split sessions by.
hostname, referrer, channel, country, region, city, language, browser, operating_system, device_type, ai_assistant, utm_source, utm_medium, utm_campaign, utm_term, utm_content minute, five_minutes, ten_minutes, fifteen_minutes, hour, day, week, month, year How many top values (by total sessions) to return as series. Default 100, max 1000.
Response
Success.
Related topics
Export Analytics DataTinyAnalytics Agent Skills for AI Coding AgentsWeb Analytics Dashboard