List Tracks by Artist

​

Tracks by this artist, including featured collaborations. Supports pagination via offset/limit, filtering by artist_type and by track version_* flags (version_only, version_and, version_or, version_not). Top-level total is the ES-backed artist track count. Mash-up tracks are currently treated as original tracks.

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
  • offset
    Type: integer
    min:  
    0

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

  • limit
    Type: integer
    min:  
    1
    max:  
    200

    Maximum number of tracks to return. Defaults to 10, max 200.

  • artist_type
    Type: string enum

    Filter by artist role on the track. Omit to return both.

    values
    • main
    • featured
  • version_only[]
    Type: array string[] enum

    Return only tracks matching ALL of these version types (AND logic). CANNOT be combined with version_and, version_or, or version_not.

    values
    • original
    • re_release
    • edit
    • remix
    • acoustic
  • version_and[]
    Type: array string[] enum

    Return tracks that have ALL of these version types (AND logic). CANNOT be combined with version_only or version_or. Can be combined with version_not.

    values
    • original
    • re_release
    • edit
    • remix
    • acoustic
  • version_or[]
    Type: array string[] enum

    Return tracks that have ANY of these version types (OR logic). CANNOT be combined with version_only or version_and. Can be combined with version_not.

    values
    • original
    • re_release
    • edit
    • remix
    • acoustic
  • version_not[]
    Type: array string[] enum

    Exclude tracks matching any of these version types. CANNOT be combined with version_only. Can be combined with version_and or version_or.

    values
    • original
    • re_release
    • edit
    • remix
    • acoustic
Responses
  • application/json
Request Example for get/api/artist/{id}/tracks
curl https://api.chartmetric.com/api/artist/2/tracks \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "id": 12570005,
      "isrc": "GBBKS1200020",
      "artist_type": "featured",
      "cm_artist": [
        965,
        3986
      ],
      "artist_names": [
        "Bobby Womack",
        "Lana Del Rey"
      ],
      "code2s": [
        "US",
        "US"
      ],
      "artist_images": [
        null,
        null
      ],
      "artist_covers": [
        null,
        null
      ],
      "spotify_track_ids": [
        "3Z1C7835mW8HCXECwVT5pB"
      ],
      "spotify_album_ids": [
        "3Oy5qaBEIzs9KZVDMwvYI5"
      ],
      "spotify_duration_ms": 259906,
      "itunes_track_ids": [
        "609128028"
      ],
      "itunes_album_ids": [
        "609127619"
      ],
      "storefronts": [
        "US"
      ],
      "deezer_track_ids": [
        "32936061"
      ],
      "deezer_album_ids": [
        3174991
      ],
      "deezer_duration": 258,
      "amazon_track_ids": null,
      "amazon_album_ids": null,
      "album_ids": [
        140496
      ],
      "album_names": [
        "The Bravest Man in the Universe"
      ],
      "album_upc": [
        "614027871569"
      ],
      "album_label": [
        "XL Recordings"
      ],
      "release_dates": [
        "2012-06-08T00:00:00.000Z"
      ],
      "created_at": "2025-08-01T04:38:14Z",
      "image_url": "https://i.scdn.co/image/8feee61973cc047e433e6f150b2be32e354ba503",
      "name": "Dayglo Reflection",
      "cm_track": 12570005,
      "cm_track_cluster": {
        "cluster_id": 12570005,
        "track_types": [
          "original",
          "clean"
        ]
      },
      "cm_statistics": {
        "cm_track": 12570005,
        "num_sp_playlists": 2886,
        "num_sp_editorial_playlists": 2,
        "sp_playlist_total_reach": 548058,
        "sp_popularity": 40
      },
      "version_types": {
        "original": true,
        "re_release": false,
        "edit": false,
        "clean": false,
        "other": false
      }
    }
  ],
  "total": 120
}

Success