Artist API Methods

Description for artist related api calls.

artist/search

http://api.play.fm/artist/search/[your_api_key]

Parameter

  • name (optional) - the label name in question
  • country (optional) - the country US / AT / DE ...
  • city (optional) - the exact city name
  • style (optional) - the style in question (techno, house, ...)
  • page (optional)
  • itemsPerPage (optional, max/default 50)
NOTE: Parameters are to be considered as key-value pairs, separated by a slash (see examples below).

Examples

All Artists
http://api.play.fm/artist/search/1be42c016037b4d3182c:52c69e3a57

All Artists with "hell" in name
http://api.play.fm/artist/search/1be42c016037b4d3182c:52c69e3a57/name/hell/itemsPerPage/10/page/1

All Artists with style "techno"
http://api.play.fm/artist/search/1be42c016037b4d3182c:52c69e3a57/style/techno

Response

<results>
  <opensearch:Query role="request" searchTerms="" startPage="1"/>
  <opensearch:totalResults>406398</opensearch:totalResults>
  <opensearch:startIndex>0</opensearch:startIndex>
  <opensearch:itemsPerPagex>2</opensearch:itemsPerPagex>
 
  <matches results="2">
    <artist slug="hell" id="1185">
      <name>Hell</name>
      <url>http://www.play.fm/artist/hell</url>
      <recordings count="13">
        <rss_popular>http://www.play.fm/recordings/rss/artist/hell/total</rss_popular>
        <rss_recent>http://www.play.fm/recordings/rss/artist/hell</rss_recent>
      </recordings>    
      <image>http://static.play.fm/thumbs/big/center/middle/1_49c54e95-1c6a-3c95377e.jpg</image>
      <thumbnail>http://static.play.fm/thumbs/small/center/middle/1_49c54e95-1c6a-3c95377e.jpg</thumbnail>
    </artist>
    <artist slug="markusschulz" id="1570">
      <name>Markus Schulz</name>
      <country>US</country>
      <city>Miami</city>
      <url>http://www.play.fm/artist/markusschulz</url>
      <recordings count="73">
        <rss_popular>http://www.play.fm/recordings/rss/artist/markusschulz/total</rss_popular>
        <rss_recent>http://www.play.fm/recordings/rss/artist/markusschulz</rss_recent>
      </recordings>
      <image>http://static.play.fm/thumbs/big/center/middle/0_49ee4926-84f2-610efc27.jpg</image>
      <thumbnail>http://static.play.fm/thumbs/small/center/middle/0_49ee4926-84f2-610efc27.jpg</thumbnail>
    </artist>
  </matches>
</results>
(c) 2013 PLAY.FM GmbH

Sitemap