---
title: "Get Spotify Artist Charts"
method: GET
path: "/api/charts/spotify/artists"
tags: ["Charts"]
---

# Get Spotify Artist Charts

`GET /api/charts/spotify/artists`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/charts/spotify/artists`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/charts/spotify/artists/get.ts> (a function with typed inputs; its response is checked against the schema)

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` string, date-time: Date for the time-slice (YYYY-MM-DD). Required unless `latest=true`.
- `interval` 'daily' | 'weekly' | 'monthly', required: Chart interval (e.g. `daily`, `weekly`, `monthly`).
- `type` 'monthly_listeners' | 'popularity' | 'followers' | 'playlist_count' | 'playlist_reach', required: Spotify artist chart type (e.g. `top_artists`).
- `latest` boolean: If true, use the most recently available date and ignore `date`.
- `offset` integer: Number of items to skip from the start of the result set; pair with `limit` to paginate.

## Response `200`

Success

- object
  - `obj` object
    - `length` integer, required: Number of chart rows in `data`.
    - `data` object[], required: List of artist chart rows.
      - `id` integer, nullable: Chartmetric artist ID.
      - `name` string, nullable: Artist name.
      - `image_url` string, nullable: Artist image URL.
      - `isni` string, nullable: International Standard Name Identifier (ISNI).
      - `code2` string, nullable: Artist country code (ISO 3166-1 alpha-2).
      - `hometown_city` string, nullable: Artist hometown city.
      - `current_city` string, nullable: Artist current city.
      - `sp_followers` integer, nullable: Spotify followers count.
      - `sp_popularity` integer, nullable: Spotify popularity score (0–100).
      - `sp_monthly_listeners` integer, nullable: Spotify monthly listeners count.
      - `deezer_fans` integer, nullable: Deezer fans count.
      - `tags` unknown[], nullable: Genre tags associated with the artist.
        - unknown
      - `spotify_artist_ids` union[], nullable: Spotify artist IDs linked to this Chartmetric artist.
        - union
          - integer
          - string
      - `itunes_artist_ids` union[], nullable: iTunes artist IDs linked to this Chartmetric artist.
        - union
          - integer
          - string
      - `deezer_artist_ids` union[], nullable: Deezer artist IDs linked to this Chartmetric artist.
        - union
          - integer
          - string
      - `amazon_artist_ids` union[], nullable: Amazon artist IDs linked to this Chartmetric artist.
        - union
          - integer
          - string
      - `cm_artist_rank` integer, nullable: Chartmetric artist rank.
      - `cm_artist_score` number, float, nullable: Chartmetric artist score.
      - `timestp` string, date-time, nullable: Timestamp of the chart row.
      - `monthly_playlist_reach` integer, nullable: Sum of follower counts across playlists containing this artist's tracks.
      - `rank` integer, nullable: Current chart rank (1 = top).
      - `change` integer, nullable: Rank change from the previous interval (negative = climbed).
      - `streak` integer, nullable: Number of consecutive intervals charted.
      - `peak_date` string, date-time, nullable: Date the artist achieved its peak rank.
      - `peak_rank` integer, nullable: Best (lowest-numbered) rank achieved.
      - `time_on_chart` union: Total intervals (days/weeks/months) charted.
        - number, float
        - string
      - `rankStats` object[], nullable: Historical rank samples for this artist.
        - `date` string, nullable: Date the rank was recorded (`YYYY-MM-DD`).
        - `rank` union: Rank at `date`.
          - number, float
          - string

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)