List Chart Appearances for an Artist

Chart records for an artist across the supported platforms: Amazon, Spotify (spotify_viral_daily, spotify_viral_weekly, spotify_top_daily, spotify_top_weekly), Apple Music (applemusic_top, applemusic_daily, applemusic_albums), iTunes (itunes_top, itunes_albums), YouTube (youtube_tracks, youtube_videos, youtube_trends), and Shazam (shazam). Date range up to 365 days between since and until. Response shape: { obj: { data: { entries: [...], uniqueEntities: [...] }, length } }. shazam preserves its legacy shape — snake_case entry fields and a uniqueTracks rollup in place of uniqueEntities.

Path Parameters

type
Type: stringenum
required

Chart type. One of spotify_viral_daily, spotify_viral_weekly, spotify_top_daily, spotify_top_weekly, applemusic_top, applemusic_daily, applemusic_albums, itunes_top, itunes_albums, shazam, beatport, youtube, youtube_tracks, youtube_videos, youtube_trends, amazon. Selects platform + chart kind (e.g. spotify_viral_daily, applemusic_albums, youtube_trends).
values
- spotify_viral_daily
- spotify_viral_weekly
- spotify_top_daily
- spotify_top_weekly
- applemusic_top
- applemusic_daily
- applemusic_albums
- itunes_top
id
Type: integer
min:
2
max:
2147483647
required

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

Query Parameters

since
Type: stringFormat: date

Start date in ISO format (e.g. '2025-11-01'). Defaults to 180 days ago. Window must not exceed 365 days.
until
Type: stringFormat: date

End date in ISO format (e.g. '2025-11-15'). Defaults to today. Window must not exceed 365 days from since.
duration
Type: string | nullenum

Optional chart duration when applicable. One of daily, weekly, monthly, semi-yearly, yearly, all_time or null.

values
dailyweeklymonthlysemi-yearlyyearlyall_time

Responses

application/json

get/api/artist/{id}/{type}/charts

curl 'https://api.chartmetric.com/api/artist/2/spotify_viral_daily/charts?since=2026-04-19&until=2026-10-16&duration=daily' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": {
    "data": {
      "entries": [
        {
          "spotify_id": 14455213,
          "rank": 111,
          "added_at": "2020-03-03T08:00:00.000Z",
          "code2": "AU",
          "plays": 40234,
          "duration": "daily",
          "chart_type": "regional",
          "chart_name": "DAILY",
          "gnp": "351182.00",
          "pre_rank": 117,
          "peak_rank": 73,
          "peak_date": "2019-12-05T08:00:00.000Z",
          "peak_plays": 58816,
          "total_plays": "7805075",
          "id": 14455213,
          "name": "Woke Up Late (feat. Hailee Steinfeld)",
          "isrc": "QMCE31801829",
          "spotify_album_id": "5gdsguQxwQQlpTi1SU3tbY",
          "image_url": "https://i.scdn.co/image/5b41143718f3e76ddf0bf10600ca511102a0a105",
          "spotify_popularity": 62,
          "cm_track": 22310714,
          "spotify_artist_names": [
            "Drax Project",
            "Hailee Steinfeld"
          ],
          "track_genre": "dance pop,pop,post-teen pop,australian pop,nz pop",
          "cm_artist": [
            210051,
            4904
          ],
          "artist_names": [
            "Drax Project",
            "Hailee Steinfeld"
          ],
          "code2s": [
            "NZ",
            "US"
          ],
          "spotify_artist_ids": [
            "6S0IvKlvPMX1RtAYtVpUV8",
            "5p7f24Rk5HkUZsaS3BLG5F"
          ],
          "spotify_track_ids": [
            "4oPWkP9zQ5ANBbfdHGOvKF"
          ],
          "spotify_album_ids": [
            "5gdsguQxwQQlpTi1SU3tbY"
          ],
          "spotify_duration_ms": 181826,
          "album_ids": [
            4883983
          ],
          "album_names": [
            "Drax Project"
          ],
          "album_upc": [
            "814908028765"
          ],
          "album_label": [
            "300 Entertainment"
          ],
          "release_dates": [
            "2019-09-27T07:00:00.000Z"
          ]
        }
      ],
      "uniqueEntities": [
        {
          "entityId": "22310714",
          "name": "Woke Up Late (feat. Hailee Steinfeld)",
          "imageUrl": "https://i.scdn.co/image/5b41143718f3e76ddf0bf10600ca511102a0a105",
          "chartEvents": 2
        }
      ]
    },
    "length": 1
  }
}

Success

Cross-Platform Performance (CPP)

Get Cross-Platform Artist IDs