GET /v1/stats

GET /v1/stats — aggregations over events.

Aggregate counts or unique-visitor counts over a time range, optionally grouped and/or time-bucketed.

Auth

Required scope	read
Key kinds	rk_*

Request

GET /v1/stats?metric=count&from=…&to=…&event=signup&group_by=source,medium&interval=day
Authorization: Bearer rk_live_…

Query parameters

Name	Required	Notes
metric	no	count (default) or uniques (unique anonymous_ids, HyperLogLog estimate).
from	yes	ISO 8601 timestamp (inclusive).
to	yes	ISO 8601 timestamp (exclusive).
event	no	Filter to one event name.
group_by	no	Comma-separated columns. Allowed: event_name, source, medium, country, device_type, browser, os, path.
interval	no	hour, day, or week. Adds a bucket column to the output.
limit	no	1–1000, default 100.

Response

{
  "metric": "count",
  "rows": [
    { "source": "facebook", "medium": "paid",   "value": 6 },
    { "source": "facebook", "medium": "social", "value": 3 },
    { "source": "google",   "medium": "paid",   "value": 3 }
  ]
}

When interval is set, each row also has a bucket column:

{ "bucket": "2026-05-16 00:00:00", "source": "facebook", "value": 4 }

Examples

Daily signups by source

curl -G "https://api.millimetric.ai/v1/stats" \
  -H "Authorization: Bearer $RK_KEY" \
  --data-urlencode "metric=count" \
  --data-urlencode "from=2026-05-01T00:00:00Z" \
  --data-urlencode "to=2026-05-17T00:00:00Z" \
  --data-urlencode "event=signup" \
  --data-urlencode "group_by=source,medium" \
  --data-urlencode "interval=day"

Unique visitors per country, last 7 days

curl -G "https://api.millimetric.ai/v1/stats" \
  -H "Authorization: Bearer $RK_KEY" \
  --data-urlencode "metric=uniques" \
  --data-urlencode "from=$(date -u -v-7d +%Y-%m-%dT%H:%M:%SZ)" \
  --data-urlencode "to=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  --data-urlencode "group_by=country"

Total page views this month

curl -G "https://api.millimetric.ai/v1/stats" \
  -H "Authorization: Bearer $RK_KEY" \
  --data-urlencode "from=2026-05-01T00:00:00Z" \
  --data-urlencode "to=2026-06-01T00:00:00Z" \
  --data-urlencode "event=\$pageview"

(Note the \$ to escape the $ in shell. In code, just send "$pageview".)

Errors

• 400 invalid_group_by — column not in the allow-list. Response includes the allowed columns.

• 400 invalid_params — from/to missing or metric not one of count/uniques.