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

Get requests per connected user

GET/public/analytics/top-users
Core + Managed TransfersAuthBasicDocsSession

Your connected users in the range, the busiest first, with their requests, error rate and last request. Page with limit and offset; total is the number of 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.

integrationType
spotify | appleMusic | youtube | tidal | resso | boomplay | amazonMusic | deezer | pandora | soundCloud | youtubeMusic | napster | qobuz | qqMusic | yandexMusic | vkMusic | anghami | zvuk | gaana | jiosaavn | audiomack

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

limit
number · 20

The number of rows.

offset
number · 0

The number of rows to skip, for the next page.

Response

200application/json · UsageTopUsersResponseThe user with the most requests first.
data
object[]
required
data[].uuid
string
requiredThe integrationUserUUID of the connected user.
data[].integration_type
string
requiredThe music service.
data[].total_requests
string
requiredRequests for this user. A decimal string, so a large count stays exact.
data[].error_count
string
requiredRequests for this user that failed. A decimal string, so a large count stays exact.
data[].error_rate
number
requirederror_count / total_requests in percent, two decimals.
data[].avg_response_time_ms
number
requiredThe average response time in milliseconds.
data[].last_seen
string
requiredThe time of the last request in UTC, YYYY-MM-DD hh:mm:ss.
total
number
requiredThe number of connected users with requests in the range.
limit
number
requiredThe limit of this page.
offset
number
requiredThe offset of this page.
Example answer
{
  "data": [
    {
      "uuid": "string",
      "integration_type": "string",
      "total_requests": "string",
      "error_count": "string",
      "error_rate": 0,
      "avg_response_time_ms": 0,
      "last_seen": "string"
    }
  ],
  "total": 0,
  "limit": 0,
  "offset": 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.