Sections

API Methods

ARTIST.SEARCH

Search for artists in our database.

Parameters

q_artist
The song artist
f_artist_id
When set, filter by this artist id
f_artist_mbid
When set, filter by this artist musicbrainz id
page
Define the page number for paginated results
page_size
Define the page size for paginated results. Range is 1 to 100.
format
Decide the output type (json or xml)

Authentication

This method requires authentication.

Examples

Search for artists
Request
Get artists matching the name prodigy
artist.search?q_artist=prodigy&page_size=5
Json Response
{
  "message": {
    "header": {
      "status_code": 200,
      "execute_time": 0.18694400787354,
      "available": 44
    },
    "body": {
      "artist_list": [
        {
          "artist": {
            "artist_id": 13774235,
            "artist_mbid": "4a4ee089-93b1-4470-af9a-6ff575d32704",
            "artist_name": "Prodigy",
            "artist_country": "GB",
            "artist_alias_list": [
              {
                "artist_alias": "The Prodigy Vs. The Prodigy"
              },
              {
                "artist_alias": "Prodigy"
              },
              {
                "artist_alias": "Prodigy, the"
              },
              {
                "artist_alias": "Prodigy, The"
              }
            ],
            "artist_rating": 51,
            "artist_twitter_url": "http:\/\/twitter.com\/THE_PRODIGY",
            "updated_time": "2011-06-15T10:23:33Z"
          }
        },
        {
          "artist": {
            "artist_id": 16439,
            "artist_mbid": "4a4ee089-93b1-4470-af9a-6ff575d32704",
            "artist_name": "The Prodigy",
            "artist_country": "GB",
            "artist_alias_list": [
              {
                "artist_alias": "The Prodigy Vs. The Prodigy"
              },
              {
                "artist_alias": "Prodigy"
              },
              {
                "artist_alias": "Prodigy, the"
              },
              {
                "artist_alias": "Prodigy, The"
              }
            ],
            "artist_rating": 79,
            "artist_twitter_url": "http:\/\/twitter.com\/THE_PRODIGY",
            "updated_time": "2011-06-03T08:57:15Z"
          }
        },
        {
          "artist": {
            "artist_id": 13872981,
            "artist_mbid": "",
            "artist_name": "Tony Touch feat. Prodigy  ",
            "artist_country": "",
            "artist_alias_list": [

            ],
            "artist_rating": 13,
            "artist_twitter_url": "",
            "updated_time": "2012-01-16T01:20:58Z"
          }
        },
        {
          "artist": {
            "artist_id": 13770774,
            "artist_mbid": "",
            "artist_name": "Raekwon, Prodigy & Ghostface Killah",
            "artist_country": "US",
            "artist_alias_list": [

            ],
            "artist_rating": 23,
            "artist_twitter_url": "",
            "updated_time": "2012-04-28T19:24:40Z"
          }
        },
        {
          "artist": {
            "artist_id": 13869023,
            "artist_mbid": "",
            "artist_name": "Lloyd Banks feat. 50 Cent & Prodigy  ",
            "artist_country": "US",
            "artist_alias_list": [

            ],
            "artist_rating": 36,
            "artist_twitter_url": "",
            "updated_time": "2012-01-15T00:28:35Z"
          }
        }
      ]
    }
  }
}
XML Response
<?xml version="1.0" encoding="utf-8"?>
<message>
  <header>
    <status_code>200</status_code>
    <execute_time>0.065992832183838</execute_time>
    <available>44</available>
  </header>
  <body>
    <artist_list>
      <artist>
        <artist_id>13774235</artist_id>
        <artist_mbid>4a4ee089-93b1-4470-af9a-6ff575d32704</artist_mbid>
        <artist_name>Prodigy</artist_name>
        <artist_country>GB</artist_country>
        <artist_alias_list>
          <artist_alias>The Prodigy Vs. The Prodigy</artist_alias>
          <artist_alias>Prodigy</artist_alias>
          <artist_alias>Prodigy, the</artist_alias>
          <artist_alias>Prodigy, The</artist_alias>
        </artist_alias_list>
        <artist_rating>51</artist_rating>
        <artist_twitter_url>http://twitter.com/THE_PRODIGY</artist_twitter_url>
        <updated_time>2011-06-15T10:23:33Z</updated_time>
      </artist>
      <artist>
        <artist_id>16439</artist_id>
        <artist_mbid>4a4ee089-93b1-4470-af9a-6ff575d32704</artist_mbid>
        <artist_name>The Prodigy</artist_name>
        <artist_country>GB</artist_country>
        <artist_alias_list>
          <artist_alias>The Prodigy Vs. The Prodigy</artist_alias>
          <artist_alias>Prodigy</artist_alias>
          <artist_alias>Prodigy, the</artist_alias>
          <artist_alias>Prodigy, The</artist_alias>
        </artist_alias_list>
        <artist_rating>79</artist_rating>
        <artist_twitter_url>http://twitter.com/THE_PRODIGY</artist_twitter_url>
        <updated_time>2011-06-03T08:57:15Z</updated_time>
      </artist>
      <artist>
        <artist_id>13872981</artist_id>
        <artist_mbid/>
        <artist_name>Tony Touch feat. Prodigy  </artist_name>
        <artist_country/>
        <artist_alias_list/>
        <artist_rating>13</artist_rating>
        <artist_twitter_url/>
        <updated_time>2012-01-16T01:20:58Z</updated_time>
      </artist>
      <artist>
        <artist_id>13770774</artist_id>
        <artist_mbid/>
        <artist_name>Raekwon, Prodigy &amp; Ghostface Killah</artist_name>
        <artist_country>US</artist_country>
        <artist_alias_list/>
        <artist_rating>23</artist_rating>
        <artist_twitter_url/>
        <updated_time>2012-04-28T19:24:40Z</updated_time>
      </artist>
      <artist>
        <artist_id>13869023</artist_id>
        <artist_mbid/>
        <artist_name>Lloyd Banks feat. 50 Cent &amp; Prodigy  </artist_name>
        <artist_country>US</artist_country>
        <artist_alias_list/>
        <artist_rating>36</artist_rating>
        <artist_twitter_url/>
        <updated_time>2012-01-15T00:28:35Z</updated_time>
      </artist>
    </artist_list>
  </body>
</message>