Stats

Run one analytics query

One query returns a list of result rows. With no dimensions it is an aggregate (one row); with one time dimension (time[:hour|day|week|month]) it is a time series; with one breakdown dimension it is a top-N list plus a meta pagination block. The response always echoes the resolved request in query (most usefully date_range normalized to concrete [from,to] dates). At most one dimension per query.

post/query

Request

Request body

site_idinteger

Required for an all-sites key; optional for a single-site key (defaults to the key's site). Omitting it on an all-sites key → site_id_required.

metricsMetric[] required
dimensionsDimension[]

Zero or one element. Omit / empty = aggregate.

limitinteger

Breakdown queries only. Clamped to 1–1000. Sending it on an aggregate or time-series query → limit_offset_misuse.

offsetinteger

Breakdown queries only. Sending it on an aggregate or time-series query → limit_offset_misuse.

Response

Query result.

has_importboolean

True when the site has imported (e.g. GA4) data overlapping the queried window.

Changes

No recorded changes to this operation across all 1 revision of this API.