GET /api/v1/artists
Get a list of all artists with pagination.

Get a list of all artists with pagination.

Examples

GET /artists.json

{
"pages":44,
"artists":[
  {
    "artist":{
      "username":"Sixteen",
      "num_tracks":2,
      "pf_name":"Sixteen",
      "pf_facebook":null,
      "pf_twitter":null,
      "pf_website":null,
      "pf_bio":"We used to play in a van down by the river.",
      "avatar":"//gravatar.com/avatar/87f4e0b4db43ecb11079e0d44a2c3d3a?d=identicon&s=200",
      "avatar_thumb":"//gravatar.com/avatar/87f4e0b4db43ecb11079e0d44a2c3d3a?d=identicon&s=48",
      "location":{
        "id":3446,
        "name":"Not Set"
      },
      "user":{
        "username":"Sixteen"
      },
      "items":[
        {
          "item":{
            "subtype":"track",
            "upload":{
              "id":"7352gyg2nm"
            }
          }
        }
      ]
    }
  }
]
}

Supported Formats

json

Params

Param name Description
page
optional

The page to retrieve. Defaults to 1.


Value: Must be a Integer
per_page
optional

The number of results per page. Defaults to 25.


Value: Must be one of: <code>10..50</code>.
q
optional

The search parameter. If present, results will be sorted by relevancy and sort, sort_r will be ignored. Defaults to blank.


Value: Must be a String
is_podcaster
optional

Whether or not to filter on podcasts. 1 to return only podcasts, 0 to return only musicians. Defaults to blank.


Value: Must be one of: <code>0</code>, <code>1</code>.
sort
optional

How to sort the results. Will be ignored if q is present. Defaults to trending.


Value: Must be one of: <code>trending</code>, <code>top</code>, <code>recently_created</code>, <code>recently_updated</code>.
sort_r
optional

Whether or not to reverse the sort. Will be ignored if q is present. Defaults to 0.


Value: Must be one of: <code>0</code>, <code>1</code>.
include_blank
optional

Whether or not to include artists that have no tracks. Defaults to 0.


Value: Must be one of: <code>0</code>, <code>1</code>.

GET /api/v1/artists/:username
Retrieves artist object.

Retrieves artist object.

Examples

GET /artists/hungry_lucy.json

{
 "username":"Hungry_Lucy",
 "num_tracks":53,
 "pf_name":"Hungry Lucy",
 "pf_facebook":"hungrylucy",
 "pf_twitter":"",
 "pf_website":"music.hungrylucy.com",
 "pf_bio":"The duo of War-N Harrison & Christa Belle have been creating music as Hungry Lucy since 1998. Their intoxicating multi-layered music and enchanting female vocals are at once unique and accessible. To date, Hungry Lucy have released 4 CDs, a DVD, a digital-only album and appeared on numerous compilation CDs internationally as well as touring the US several times over the past 5 years. The staunchly independent duo is now seeking to expose their music through new and interesting channels.\r\n\r\nMore info at music.hungrylucy.com",
 "avatar":"https://commondatastorage.googleapis.com/k6a/uploads/profile_Hungry_Lucy",
 "avatar_thumb":"https://commondatastorage.googleapis.com/k6a/uploads/thumb_Hungry_Lucy",
 "":null,
 "items":[
    {
       "item":{
          "id":"rainfall",
          "title":"rainfall",
          "subtype":"track",
          "upload":{
             "id":"00k1gtfb9m",
             "created_at":"2013-01-19T16:37:48.000-05:00",
             "bytes":5436924,
             "downloads":204,
             "hotlinks":324,
             "ext":"mp3",
             "hotlink_path":"http://k005.kiwi6.com/hotlink/00k1gtfb9m/rainfall.mp3"
          },
          "artist":{
             "username":"Hungry_Lucy"
          }
       }
    },
    {
       "item":{
          "id":"in-the-circle",
          "title":"in the circle",
          "subtype":"track",
          "upload":{
             "id":"0pwn0ko7r1",
             "created_at":"2013-01-19T16:20:00.000-05:00",
             "bytes":5112795,
             "downloads":12,
             "hotlinks":23,
             "ext":"mp3",
             "hotlink_path":"http://k006.kiwi6.com/hotlink/0pwn0ko7r1/in_the_circle.mp3"
          },
          "artist":{
             "username":"Hungry_Lucy"
          }
       }
    }
 ]
}

Supported Formats

json

Params

Param name Description
username
required

The username of the artist to retrieve.


Value: Must be a String