SHshorebird
metrics

Unique active devices (MAU) for an app over a window.

Returns the distinct active devices ("unique users") for the app over a time window — an HLL-approximated count over hourly_user_sketches — as a current/previous envelope: current covers the effective window, previous the equal-length window immediately preceding it (always computed; powers period-over-period deltas and overlays). With granularity set, each window also carries a time_series at that resolution; with group_by set, current carries a breakdown per group (each with its own time_series when a granularity is also requested). previous never carries a breakdown. Counts are HLL approximations. The window defaults to the last 28 days and is capped at 450 days; every bound clamps and the effective range is echoed in each window's range, which clients must treat as authoritative.

get/apps/{appId}/metrics/unique-users

Request

  • Base URL
    https://api.shorebird.dev/api/v1
  • Auth
    • HTTP bearer
    • or HTTP bearer

Query parameters

startstring date-time

Window start (UTC, inclusive). Defaults to end minus 28 days.

endstring date-time

Window end (UTC, exclusive). Defaults to now. A window "ending now" must omit this parameter rather than send a client-computed timestamp — clock skew would silently turn the request into a historical query.

granularity'hour' | 'day' | 'week'

The bucket resolution of a metrics time series.

Bucket resolution for the time series. Omitted ⇒ no time_series (one merged value per window); set ⇒ one point per bucket at this resolution. When set, the window length is rounded down to a whole multiple of the bucket size (echoed in range), which guarantees current and previous have equal bucket counts.

group_by'platform' | 'release_version'

Dimension to break the total down by. Omitted ⇒ no breakdown. For release_version, devices whose client is too old to report a release version group under the empty-string group_value.

Response

The unique-users metric for the app.

as_ofstring date-time required

Server's UTC timestamp at the moment the response was constructed. Not a freshness indicator for the underlying data, which is refreshed by an hourly scheduled query and may lag by up to ~1 hour.

granularitystring nullable required

The time-series bucket resolution (hour, day, or week), or null when no time series was requested. Applies to both windows.

Changes

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