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: string enum
    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
  • 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 date in ISO format (e.g. '2025-11-01'). Defaults to 180 days ago. Window must not exceed 365 days.

  • until
    Type: string Format: 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 | null enum

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

    values
    • daily
    • weekly
    • monthly
    • semi-yearly
    • yearly
    • all_time
Responses
  • application/json
Request Example for get/api/artist/{id}/{type}/charts
curl https://api.chartmetric.com/api/artist/2/spotify_viral_daily/charts \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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