Artists
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
jsonParams
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
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 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 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
jsonParams
Param name | Description |
---|---|
username required |
The username of the artist to retrieve. Value: Must be a String |