Artists
Tracks

Get Artist's Top Tracks

Changed on

Get Spotify catalog information about an artist's top tracks by country.

get/artists/{id}/top-tracks

Request

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/artists/{id}/top-tracks
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token

Path parameters

idstring required

The Spotify ID of the artist.

Example:0TnOYISbd1XYRBk9myaseg

Query parameters

marketstring

An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned.<br/> If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.<br/> Note: If neither market or user country are provided, the content is considered unavailable for the client.<br/> Users can view the country that is associated with their account in the account settings.

Example:ES

Response

A set of tracks

Example response

{
  "tracks": [
    {
      "album": {
        "album_type": "compilation",
        "total_tracks": 9,
        "available_markets": [
          "CA",
          "BR",
          "IT"
        ],
        "id": "2up3OPMp9Tb4dAKM2erWXQ",
        "images": [
          {
            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
            "height": 300,
            "width": 300
          }
        ],
        "release_date": "1981-12",
        "release_date_precision": "year",
        "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ"
      }
    }
  ]
}

Changes

  • 1602059e3988Revision changes
    • info

      response property tracks/items/external_ids reactivated

  • 8899d6fd66eeRevision changes
    • info

      endpoint deprecated

    • info

      response property tracks/items/album/allOf[SimplifiedAlbumObject]/allOf[AlbumBase]/available_markets deprecated

    • info

      response property tracks/items/available_markets deprecated

    • info

      response property tracks/items/external_ids deprecated

    • info

      response property tracks/items/linked_from deprecated

    • info

      response property tracks/items/popularity deprecated