Recording API Methods

Description for recording related api calls.

recording/search

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

Parameter

• title (optional) - the recording title in question
• style (optional) - the style in question (techno, house, ...)
• artist (optional) - the artist in question (name or slug)
• type (optional) - the typeof the recordings(studio, event, radio, interview)
• order (optional) - chrono (default) or popular (sorted by listen time descending)
• page (optional)
• itemsPerPage (optional, max/default 50)

Examples

All Recordings
http://api.play.fm/recording/search/1be42c016037b4d3182c:52c69e3a57

All Recordings with "hell" in title
http://api.play.fm/recording/search/1be42c016037b4d3182c:52c69e3a57/title/hell/itemsPerPage/10/page/1

All Recordings for style "techno"
http://api.play.fm/recording/search/1be42c016037b4d3182c:52c69e3a57/style/techno

Response

<results>
  <opensearch:Query role="request" searchTerms="" startPage="1"/>
  <opensearch:totalResults>14678</opensearch:totalResults>
  <opensearch:startIndex>0</opensearch:startIndex>
  <opensearch:itemsPerPagex>3</opensearch:itemsPerPagex>
 
  <matches results="3">
 
    <recording slug="glagollfremix20976" id="20976">
      <title>Glagol LF mix</title>
      <published_at>2009-08-27 14:10:19</published_at>
      <lenght>2674128</lenght>
      <url>http://www.play.fm/recording/glagollfremix20976</url>
      <artists>
        <artist slug="mikiroot" id="212243">Miki Root</artist>
      </artists>
      <image>http://static.play.fm/thumbs/big/center/middle/2_4a3e32e8-a64a-5cc045e2.jpg</image>
      <thumbnail>http://static.play.fm/thumbs/small/center/middle/2_4a3e32e8-a64a-5cc045e2.jpg</thumbnail>
    </recording>
 
    <recording slug="montreuxjazzfestivalmdhclubmontreux_ch2009071620921" id="20921">
      <title>Montreux Jazz Festival @ MDH Club (Montreux,CH) - 2009-07-16</title>
      <published_at>2009-08-27 14:06:06</published_at>
      <lenght>3396910</lenght>
      <url>http://www.play.fm/recording/montreuxjazzfestivalmdhclubmontreux_ch2009071620921</url>
      <artists>
        <artist slug="crowdpleaser" id="1106">Crowdpleaser</artist>
      </artists>
      <image>http://static.play.fm/thumbs/big/center/middle/2_4a96771e-40a5-5a9c53b6.jpg</image>
      <thumbnail>http://static.play.fm/thumbs/small/center/middle/2_4a96771e-40a5-5a9c53b6.jpg</thumbnail>
    </recording>
 
    <recording slug="vivalaelectronicakarateklubspecialwithblood_tears2009082620977" id="20977">
      <title>Viva la Electronica Karateklub Special with Blood And Tears 2009-08-26</title>
      <published_at>2009-08-27 13:58:14</published_at>
      <lenght>3788355</lenght>
      <url>http://www.play.fm/recording/vivalaelectronicakarateklubspecialwithblood_tears2009082620977</url>
      <artists>
        <artist slug="blood_tears" id="44513">Blood And Tears</artist>
      </artists>
    </recording>
  </matches>
</results>