API reference
/
Billing and usage

Get unique users over time

GET/public/analytics/unique-users

Core + Managed TransfersAuthBasicDocsSession

The number of connected users that made at least one request in each period. Use granularity=daily for daily active users and monthly for monthly active users. Requires Client Secret authentication. Not billed.

Query parameters

startDate

stringrequired

The first day of the range (UTC), for example 2026-10-01. The day counts.

endDate

stringrequired

The last day of the range (UTC). The day counts, so startDate = endDate is one day. The range may hold at most 366 days, or 31 days for an hourly series.

granularity

hourly | daily | weekly | monthly · daily

The length of one period. A week starts on Sunday.

integrationType

Count only the requests for this music service. Leave it out for every service.

Response

200application/json · UsageUniqueUsersResponseOne row for each period with requests, oldest first.

data

object[]

required

data[].period

string

requiredThe start of the period in UTC, YYYY-MM-DD hh:mm:ss.

data[].unique_users

string

requiredConnected users that made at least one request in the period. A decimal string, so a large count stays exact.

Example answer

{
  "data": [
    {
      "period": "2026-10-01 00:00:00",
      "unique_users": "string"
    }
  ]
}

Errors

400

A date is missing or not valid, endDate is before startDate, or the range is too long.

401

The request has no credentials.

403

The request does not use Client Secret authentication.

429

Your account sent more calls this minute than its rate limit allows.