Skip to main content
GET
Group analytics by dimension

Authorizations

Authorization
string
header
required

API key issued in the dashboard. Server-side only: never ship it to a browser, and never pass it as a query parameter.

Path Parameters

id
string
required
Example:

"grp_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"

Query Parameters

start_date
integer
required

Start of the period, UTC milliseconds. Inclusive.

Example:

1755734400000

end_date
integer
required

End of the period, UTC milliseconds. Inclusive, and silently clamped to the current server time if it lies in the future.

Example:

1756339200000

timezone
string
required

IANA timezone. Buckets and the activity grid are cut in it; totals do not depend on it.

Maximum string length: 64
Example:

"Europe/Belgrade"

dimension
enum<string>
required
Available options:
referrer,
channel,
browser,
os,
device,
country,
city
limit
integer
default:10

How many rows to return. There is no cursor: the composition of a top changes with every new event.

Required range: 1 <= x <= 100

Response

object
enum<string>
required
Available options:
analytics_breakdown
dimension
enum<string>
required
Available options:
referrer,
channel,
browser,
os,
device,
country,
city
items
object[]
required

Named items, not data: the envelope key data belongs to resource lists. No cursor here — the composition of a top changes with every new event.