Spotify Monthly Listeners by City / Country

​

Spotify "Where people listen" snapshots for the artist — listener counts keyed by city / country name with historical time-series or latest snapshot. Pass latest=true (or a specific date) to receive snapshot form; omit both for a time-series between since / until. Spotify data for top 50 cities is real prior to Aug 12, 2024; after that date the platform only provides estimates and missing days are filled by the Chartmetric model (is_estimate: true).

Path Parameters
  • id
    Type: integer
    min:  
    2
    max:  
    2147483647
    required

    Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.

    • enum
      const:  
      1
      values
      • 1
Query Parameters
  • since
    Type: string Format: date

    Start of the date window in ISO format (e.g. '2025-11-01'). Defaults to 180 days ago. Ignored when latest=true or date is supplied.

  • until
    Type: string Format: date

    End of the date window in ISO format (e.g. '2025-11-15'). Defaults to today. Ignored when latest=true or date is supplied.

  • offset
    Type: integer
    min:  
    0

    Number of locations to skip from the start of the result set, applied to cities and countries independently.

  • limit
    Type: integer
    min:  
    0
    max:  
    50

    Maximum number of locations to return, applied to cities and countries independently. Defaults to 10, max 50.

  • latest
    Type: boolean

    If true, returns only the most recent snapshot and ignores since/until.

  • date
    Type: string Format: date

    Single-date snapshot in ISO format (YYYY-MM-DD). When set, returns one snapshot for that date and since/until are ignored.

  • includeEstimates
    Type: boolean

    If true (default), include Chartmetric-estimated city/country listener counts where Spotify no longer publishes real values (post 2024-08-12). Set to false to return only confirmed source data.

Responses
  • application/json
Request Example for get/api/artist/{id}/where-people-listen
curl https://api.chartmetric.com/api/artist/2/where-people-listen \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "cities": {
      "Brisbane": [
        {
          "timestp": "2024-10-15T07:00:00.000Z",
          "code2": "AU",
          "spotify_artist_id": "06HL4z0CvFAxyc27GXpf02",
          "lat": -27.455,
          "lng": 153.0351,
          "region": "CITY",
          "city_id": 591,
          "spotify_artist_insights_location": null,
          "current_max_count": 616040,
          "market_max_cm_artist_id": 212715,
          "market_max_artist_name": "Morgan Wallen",
          "listeners": 625990,
          "prev_listeners": 621474,
          "artist_city_rank": null,
          "max_listeners": 92958654,
          "population": 2360241,
          "city_affinity": null,
          "is_estimate": true
        }
      ]
    },
    "countries": {
      "Australia": [
        {
          "timestp": "2024-10-15T07:00:00.000Z",
          "code2": "AU",
          "spotify_artist_id": "06HL4z0CvFAxyc27GXpf02",
          "lat": -25.274398,
          "lng": 133.775136,
          "region": "COUNTRY",
          "city_id": 591,
          "spotify_artist_insights_location": null,
          "current_max_count": 616040,
          "market_max_cm_artist_id": null,
          "market_max_artist_name": null,
          "listeners": 5497904,
          "prev_listeners": 5508062,
          "artist_city_rank": null,
          "max_listeners": 92958654,
          "population": 26033500,
          "city_affinity": null,
          "is_estimate": true
        }
      ]
    }
  }
}

Success