GET ​/api​/v3​/account​/me​/artist_profile​/tracks

Retrieve the artist tracks and albums for this account.

Request

Example Request

{
  "auth_token": "abc1245920feab98ca"
}

Example Parameters

  • auth_token: The user's auth_token obtained by calling the auth API.
    • Required: yes
    • Type: string
    • Example: abc1245920feab98ca

Response

Example Response

{
  "tracks": null,
  "albums": [
    {
      "id": 1,
      "title": "Yankee Hotel Foxtrot",
      "year": 2002,
      "artwork": [
        {
          "thumb": {
            "url": "http://example.com/album_thumb.png"
          },
          "mini_profile": {
            "url": "http://example.com/album_mini_profile.png"
          }
        }
      ],
      "credits": "Jeff Tweedy - Composer, Horn, String Arrangements",
      "producer": "Wilco",
      "record_label": "Nonesuch",
      "recorded_at": "The Loft (Chicago, IL, US)",
      "primary_genre": "Rock",
      "secondary_genre": "Alternative Rock",
      "tag_list": "garage, psych",
      "position": 1,
      "is_downloadable": true,
      "price": "9.99",
      "download_type": "fixed",
      "itunes_url": "http://example.com/album",
      "amazon_url": "http://example.com/album",
      "external_url": "http://example.com/album"
    }
  ]
}

Response Parameters

  • tracks: The artist's tracks

    • Required: no
    • Type:
      • null
      • array
    • Items

      • Required: no
      • id: The unique ID of the track
        • Required: yes
        • Type: integer
        • Example: 1
      • album_id: The unique ID of the album. Can be used to lookup in top-level albums key.
        • Required: yes
        • Type: integer
        • Example: 1
      • track_number: The album track number
        • Required: no
        • Type: integer
        • Example: 1
      • title: The track title
        • Required: no
        • Type: string
        • Example: I Am Trying to Break Your Heart
      • duration: The duration of the track. In minutes:seconds format.
        • Required: yes
        • Type: string
        • Example: 06:58
      • position: The track sort/display position
        • Required: no
        • Type: integer
        • Example: 1
      • single: Whether or not the track is a single. These are given higher priority when building playlists for upcoming shows, etc.
        • Required: no
        • Type: boolean
      • isdownloadon: Whether or not the track can be downloaded
        • Required: no
        • Type: boolean
      • download_url: The track download URL
        • Required: no
        • Type:
          • null
          • string
        • Example: http://example.com/track.mp3"
  • albums: The artist's albums

    • Required: no
    • Type: array
    • Items

      • Required: no
      • id: The unique ID of the album
        • Required: yes
        • Type: integer
        • Example: 1
      • title: The album title
        • Required: no
        • Type: string
        • Example: Yankee Hotel Foxtrot
      • year: The year the album was released
        • Required: no
        • Type: integer
        • Example: 2002
      • artwork: The album cover image details

        • Required: no
        • Type: array
        • Items

          • Required: no
          • __thumb__: The thumbnail size album cover image URL

          • __mini_profile__: The mini profile size album cover image URL

      • credits: Credits and/or notes about the production of the album

        • Required: no
        • Type:
          • null
          • string
        • Example: Jeff Tweedy - Composer, Horn, String Arrangements
      • producer: The album's producer

        • Required: no
        • Type:
          • null
          • string
        • Example: Wilco
      • record_label: The album's record label

        • Required: no
        • Type:
          • null
          • string
        • Example: Nonesuch
      • recorded_at: The location(s) where the album was recorded

        • Required: no
        • Type:
          • null
          • string
        • Example: The Loft (Chicago, IL, US)
      • primary_genre: The album's primary genre

        • Required: no
        • Type:
          • null
          • string
        • Example: Rock
      • secondary_genre: The album's secondary genre

        • Required: no
        • Type:
          • null
          • string
        • Example: Alternative Rock
      • tag_list: Additional album genre tags

        • Required: no
        • Type:
          • null
          • array
        • Example: garage, psych
      • position: The album sort/display position

        • Required: no
        • Type: integer
        • Example: 1
      • is_downloadable: Whether or not the album can be downloaded

        • Required: no
        • Type: boolean
      • price: The album price

        • Required: no
        • Type: string
        • Example: 9.99
      • download_type: The album download type. Valid values are "range" (pay-what-you-want above the specified minimum price), "free", "fixed" (only the specified price), or "external" (the price specified on iTunes, Amazon, or the external URL).

        • Required: no
        • Type:
          • null
          • string
        • Example: fixed
      • itunes_url: The URL for purchasing the album on iTunes

        • Required: no
        • Type:
          • null
          • string
        • Example: http://example.com/album
      • amazon_url: The URL for purchasing the album on Amazon

        • Required: no
        • Type:
          • null
          • string
        • Example: http://example.com/album
      • external_url: The URL for purchasing the album on an external site

        • Required: no
        • Type:
          • null
          • string
        • Example: http://example.com/album

Response Codes

Successful Response Codes

  • 200: The tracks and albums were successfully retrieved.

Failure Response Codes

  • 401: Unauthorized request. Indicates a missing or invalid auth_token. This endpoint requires an admin account.