Get Spotify Artist Charts

​

Return artists charting on Spotify (official daily/weekly/monthly artist charts). Each entry carries the artist basic info joined with the current chart position, streak, peak, and a short rankStats history. Handler strips the internal cm_artist field before returning.

Query Parameters
  • date
    Type: string Format: date-time

    Date for the time-slice (YYYY-MM-DD). Required unless latest=true.

  • interval
    Type: string enum
    required

    Chart interval (e.g. daily, weekly, monthly).

    values
    • daily
    • weekly
    • monthly
  • type
    Type: string enum
    required

    Spotify artist chart type (e.g. top_artists).

    values
    • monthly_listeners
    • popularity
    • followers
    • playlist_count
    • playlist_reach
  • latest
    Type: boolean

    If true, use the most recently available date and ignore date.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

Responses
  • application/json
Request Example for get/api/charts/spotify/artists
curl 'https://api.chartmetric.com/api/charts/spotify/artists?interval=daily&type=monthly_listeners' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": 1,
    "data": [
      {
        "id": 123,
        "name": "Ariana Grande",
        "image_url": "https://i.scdn.co/image/abcd",
        "isni": null,
        "code2": "US",
        "hometown_city": "Boca Raton",
        "current_city": null,
        "sp_followers": 88000000,
        "sp_popularity": 95,
        "sp_monthly_listeners": 72000000,
        "deezer_fans": 1200000,
        "tags": [
          "pop"
        ],
        "spotify_artist_ids": [
          "66CXWjxzNUsdJxJ2JdwvnR"
        ],
        "itunes_artist_ids": [
          "412778295"
        ],
        "deezer_artist_ids": [
          "3542823"
        ],
        "amazon_artist_ids": null,
        "cm_artist_rank": 12,
        "cm_artist_score": 99.2,
        "timestp": "2024-05-01T00:00:00.000Z",
        "monthly_playlist_reach": 50000000,
        "rank": 1,
        "change": 0,
        "streak": 12,
        "peak_date": "2024-04-01T00:00:00.000Z",
        "peak_rank": 1,
        "time_on_chart": 52,
        "rankStats": [
          {
            "date": "2024-05-01",
            "rank": "1"
          }
        ]
      }
    ]
  }
}

Success