Skip to the content
Get an API key
  1. API reference
  2. Billing and usage

Get unique users per service

GET/public/analytics/users-per-type
Core + Managed TransfersAuthBasicDocsSession

The number of connected users of each music service that made at least one request in the range. 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.

Response

200application/json · UsageUsersPerTypeResponseThe service with the most users first.
data
object[]
required
data[].integration_type
string
requiredThe music service.
data[].unique_users
string
requiredConnected users of this service that made at least one request. A decimal string, so a large count stays exact.
totalUniqueUsers
number
requiredThe sum of unique_users over all services.
Example answer
{
  "data": [
    {
      "integration_type": "string",
      "unique_users": "string"
    }
  ],
  "totalUniqueUsers": 0
}

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.