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

Get response times over time

GET/public/analytics/response-times
Core + Managed TransfersAuthBasicDocsSession

The average, median, 95th and 99th percentile response times of your requests in each period. 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
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.

Response

200application/json · UsageResponseTimesResponseOne 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[].avg_ms
number
requiredThe average response time in milliseconds.
data[].p50_ms
number
requiredThe median response time in milliseconds.
data[].p95_ms
number
requiredThe 95th percentile in milliseconds.
data[].p99_ms
number
requiredThe 99th percentile in milliseconds.
Example answer
{
  "data": [
    {
      "period": "2026-10-01 00:00:00",
      "avg_ms": 0,
      "p50_ms": 0,
      "p95_ms": 0,
      "p99_ms": 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.