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

Get requests per country

GET/public/analytics/geo-distribution
Core + Managed TransfersAuthBasicDocsSession

The countries that your requests come from, with the number of requests and connected users of each. 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.

Response

200application/json · UsageGeoDistributionResponseThe country with the most requests first.
data
object[]
required
data[].country_code
string
requiredThe ISO 3166-1 alpha-2 country of the request.
data[].total_requests
string
requiredRequests from this country. A decimal string, so a large count stays exact.
data[].unique_users
string
requiredConnected users with requests from this country. A decimal string, so a large count stays exact.
Example answer
{
  "data": [
    {
      "country_code": "string",
      "total_requests": "string",
      "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.