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>.