GET ​/api​/v3​/artist​/:id

Returns artist details. ‘upcoming_gigs’ is deprecated. Please use ‘shows’ and ‘venues’.

Request

Example Request

{
  "auth_token": "ef43987dc3dfca56255915d3b109714ecd4516ac54f527"
}

Example Parameters

  • auth_token: The auth_token of the previously authenticated user. Retrieve this from the auth api.
    • Required: no
    • Type: string
    • Example: ef43987dc3dfca56255915d3b109714ecd4516ac54f527

Response

Example Response

{
  "artist": {
    "id": 1,
    "name": "The Rolling Stones",
    "slug": "rolling-stones",
    "facebook_url": "http://www.facebook.com/rollingstones",
    "location": "Houston, TX",
    "genres": [
      "Rock"
    ],
    "official_station_id": {
    },
    "tracks_count": {
    },
    "url": "http://www.therollingstones.com/",
    "twitter_handle": "rollingstones",
    "you_follow": true,
    "media": {
      "photos": [
        {
          "id": 1,
          "small": {
            "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/preview_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
          },
          "small_hq": {
            "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/preview_retina_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
          },
          "medium": {
            "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/small_wide_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
          },
          "medium_hq": {
            "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/small_wide_retina_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
          },
          "large": {
            "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/fullscreen_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
          },
          "large_hq": {
            "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/fullscreen_retina_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
          },
          "cover_980": {
            "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/cover_980_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
          }
        }
      ]
    },
    "albums": [
      {
        "id": 1,
        "title": "Exile on Main St.",
        "year": 2010,
        "image_url": "https://deliradio.s3.amazonaws.com/artwork/4/image.jpg",
        "external_url": "http://www.cdbaby.com/cd/exile",
        "itunes_url": "http://itunes.apple.com/us/album/exile/id123",
        "amazon_url": "http://www.amazon.com/Exile/dp/B000123",
        "tracks": [
          {
            "id": 3,
            "title": "Shine on you Crazy Diamond",
            "duration": "03:18",
            "single": true,
            "position": 10
          }
        ]
      }
    ],
    "bio": "Funky towns best ensemble",
    "upcoming_gigs": [
      {
        "id": 1,
        "name": "The Palladium",
        "location": "Houston, TX, US",
        "date": "Oct 26, 2013 21:51",
        "lat": "29.7631",
        "long": "-95.3631",
        "venue_id": 1
      }
    ],
    "shows": [
      {
        "id": 81,
        "venue_id": 12,
        "artist_id": 1,
        "show_time": "2014-01-09 21:00:04 UTC",
        "ticket_url": "http://deliradio.com/go?bid=123&bn=The+Classic+Crime&url=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F7402810%2Fbuy_tickets%3Fartist%3DCrime"
      }
    ],
    "venues": [
      {
        "id": 12,
        "name": "The Palladium",
        "address": "Cincinnati, OH, US",
        "capacity": 100,
        "city": "Houston, TX, US",
        "description": "Featuring Magnifi",
        "lat": "29.7631",
        "lng": "-95.3631",
        "slug": "palladium-radio",
        "twitter_username": "@brooklynbowl",
        "website_url": "http://www.socialhallsf.com/"
      }
    ]
  }
}

Response Parameters

  • artist:

    • Required: no
    • id: The unique ID of the artist
      • Required: yes
      • Type: integer
      • Example: 1
    • name: The name of the artist
      • Required: yes
      • Type: string
      • Example: The Rolling Stones
    • slug: The unique slug for an artist
      • Required: yes
      • Type: string
      • Example: rolling-stones
    • facebook_url: The facebook url for the artist
      • Required: yes
      • Type:
        • null
        • string
      • Example: http://www.facebook.com/rollingstones
    • location: The location of the artist
      • Required: yes
      • Type: string
      • Example: Houston, TX
    • genres: Genres associated with the artist

      • Required: yes
      • Type: array
      • Items

        • Required: no
        • Type: string
        • Example: Rock
    • officialstationid: The official station id for this artist

      • Required: no
      • Type: Number
      • Example: 12412
    • tracks_count: Count of tracks this artist has

      • Required: no
      • Type: Number
      • Example: 1
    • url: The URL to the artists website

      • Required: yes
      • Type:
        • null
        • string
      • Format: uri
      • Example: http://www.therollingstones.com/
    • twitter_handle: The twitter handle of the band

      • Required: yes
      • Type:
        • null
        • string
      • Example: rollingstones
    • you_follow: Indicates whether the current user follows this artist.

      • Required: yes
      • Type: boolean
      • Example: true
    • media:

      • Required: yes
      • photos: Photos of the artist

        • Required: yes
        • Type: array
        • Items

          • Required: no
          • id: The unique ID of the photo
          • __small__: A small non-retina artist photo

          • __small_hq__: A retina preview artist photo

          • __medium__: A medium sized artist photo

          • __medium_hq__: A medium retina sized artist photo

          • __large__: A large sized artist photo

          • __large_hq__: A fullscreen retina artist photo

          • __cover_980__: A 16:9 artist photo, 980px wide

    • albums: Albums by the artist

      • Required: yes
      • Type: array
      • Items

        • Required: no
        • id: The unique ID of the album
          • Required: yes
          • Type: integer
          • Example: 1
        • title: The title of the album
          • Required: yes
          • Type: string
          • Example: Exile on Main St.
        • year: The year of the album
          • Required: yes
          • Type: integer
          • Example: 2010
        • image_url: An image for the album
          • Required: yes
          • Type: string
          • Example: https://deliradio.s3.amazonaws.com/artwork/4/image.jpg
        • external_url: The external link to the album
          • Required: yes
          • Type: string
          • Example: http://www.cdbaby.com/cd/exile
        • itunes_url: The link to the album on itunes
          • Required: yes
          • Type: string
          • Example: http://itunes.apple.com/us/album/exile/id123
        • amazon_url: The link to the album on amazon
          • Required: yes
          • Type: string
          • Example: http://www.amazon.com/Exile/dp/B000123
        • tracks: The tracks in the album

          • Required: yes
          • Type: array
          • Items A track in the album.

    • bio: The artist biography

      • Required: yes
      • Type: string
      • Example: Funky towns best ensemble
    • upcoming_gigs: DEPRECATED. Please use the shows and venues portion of the response

      • Required: yes
      • Type: array
      • Items

        • Required: no
        • id: The unique ID of the gig
          • Required: yes
          • Type: integer
          • Example: 1
        • name: The name of the venue
          • Required: yes
          • Type: string
          • Example: The Palladium
        • location: The location of the venue
          • Required: yes
          • Type: string
          • Example: Houston, TX, US
        • date: The date of the gig
          • Required: yes
          • Type: string
          • Example: Oct 26, 2013 21:51
        • lat: The latitude of the venue
          • Required: yes
          • Type: string
          • Example: 29.7631
        • long: The longitude of the venue
          • Required: yes
          • Type: string
          • Example: -95.3631
        • venue_id: The unique ID of the venue
          • Required: no
          • Type: integer
          • Example: 1
    • shows: The list of shows

      • Required: yes
      • Type: array
      • Items

        • Required: yes
        • id: The id of the show
          • Required: yes
          • Type: integer
          • Example: 81
        • venue_id: The id of the venue
          • Required: yes
          • Type: integer
          • Example: 12
        • artist_id: The id of the artist
          • Required: yes
          • Type: integer
          • Example: 1
        • show_time: The date and time of the show, in UTC.
          • Required: yes
          • Type: string
          • Example: 2014-01-09 21:00:04 UTC
        • ticket_url: the url for tickets to the show
          • Required: yes
          • Type: string
          • Example: http://deliradio.com/go?bid=123&bn=The+Classic+Crime&url=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F7402810%2Fbuy_tickets%3Fartist%3DCrime
    • venues: A lookup array of venues represented in the shows above.

      • Required: yes
      • Type: array
      • Items ???

        • Required: yes
        • id: The id of the venue
          • Required: yes
          • Type: integer
          • Example: 12
        • name: The name of the venue
          • Required: yes
          • Type: string
          • Example: The Palladium
        • address: Street address of venue
          • Required: no
          • Type:
            • null
            • string
          • Example: Cincinnati, OH, US
        • capacity: Capacity of venue
          • Required: yes
          • Type: integer
          • Example: 100
        • city: The city of the venue
          • Required: yes
          • Type: string
          • Example: Houston, TX, US
        • description: description of venue
          • Required: no
          • Type:
            • null
            • string
          • Example: Featuring Magnifi
        • lat: The latitude of the venue
          • Required: yes
          • Type: string
          • Example: 29.7631
        • lng: The longitude of the venue
          • Required: yes
          • Type: string
          • Example: -95.3631
        • slug: The unique slug for a venue.
          • Required: no
          • Type:
            • null
            • string
          • Example: palladium-radio
        • twitter_username: Twitter handle name of the venue
          • Required: no
          • Type:
            • null
            • string
          • Example: @brooklynbowl
        • website_url: Venue's website URL, to fallback to if ticket-url is unavailable
          • Required: no
          • Type:
            • null
            • string
          • Example: http://www.socialhallsf.com/

Response Codes

Successful Response Codes

  • 200:

Failure Response Codes

  • 404: The artist with the given ID was not found

  • 400: The artist ID passed was invalid. It should be a postitive integer.