track.search

Description: 

Searches tracks by full text search. Full text search searches for the requested word(s) within artist name, track and album title; so use this api when you want to perform searches on the above attributes.
 
Example
Say you want to get the track with:

  • title: Ashes to Ashes
  • artist: David Bowie
  • album: Scary Monsters

just use this api, using as query parameter value a string with all the words of interest; the proper call will be something like:

api.playme.com/track.search?query=david bowie ashes to ashes scary monsters&apikey=...

Authentication : NOT REQUIRED
Parameters: 
apikey : application developer identifier [R]
country : catalogue country
format : output format
order: sorting field (album_name | artist_name | track_name). If not provided, results are sorted by matching relevance in descending order.
sort: sorting direction (asc | desc)
genreCode : genre code for filtering on genre
page : result page number
step : number of elements to retrieve
query : string to search for [R]

Return values: 

List of tracks matching the query string
available : number of tracks matching the title
page : index of current page (1 - based)


Sample call
http://api.playme.com/track.search?query=placebo sun&country=us&step=2&page=2

Sample Result: XML
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <tracks>
    <track>
      <trackCode>3322008</trackCode>
      <name><![CDATA[For What It's Worth]]></name>
      <url><![CDATA[http://contents_site_url/track_page]]></url>
      <downloadUrl><![CDATA[http://download_site_url]]></downloadUrl>
      <previewUrl><![CDATA[http://preview_site_url]]></previewUrl>
      <embeddedPlayer><![CDATA[Play.me player HTML object code]]></embeddedPlayer>
      <fullStream><![CDATA[1]]></fullStream>

      <duration>167</duration>
      <publicationYear>2009</publicationYear>
      <artist>
        <artistCode>1275</artistCode>
        <name><![CDATA[Placebo]]></name>
      </artist>
      <album>
        <albumCode>3322004</albumCode>
        <name><![CDATA[Battle For The Sun]]></name>
      </album>
      <images>
        <img_256><![CDATA[http://images_site_url/image_name]]></img_256>
        <img_96><![CDATA[http://images_site_url/image_name]]></img_96>
        <img_64><![CDATA[http://images_site_url/image_name]]></img_64>
        <img_32><![CDATA[http://images_site_url/image_name]]></img_32>
      </images>
      <genre>
        <genreCode>253</genreCode>
        <name><![CDATA[Rock]]></name>
      </genre>
    </track>
    <track>
      <trackCode>3322006</trackCode>
      <name><![CDATA[Ashtray Heart]]></name>
      <url><![CDATA[http://contents_site_url/track_page]]></url>
      <downloadUrl><![CDATA[http://download_site_url/]]></downloadUrl>
      <previewUrl><![CDATA[http://preview_site_url/]]></previewUrl>
      <embeddedPlayer><![CDATA[Play.me player HTML object code]]></embeddedPlayer>
      <fullStream><![CDATA[1]]></fullStream>
      <duration>212</duration>
      <publicationYear>2009</publicationYear>
      <artist>
        <artistCode>1275</artistCode>
        <name><![CDATA[Placebo]]></name>
      </artist>
      <album>
        <albumCode>3322004</albumCode>
        <name><![CDATA[Battle For The Sun]]></name>
      </album>
      <images>
        <img_256><![CDATA[http://images_site_url/image_name]]></img_256>
        <img_96><![CDATA[http://images_site_url/image_name]]></img_96>
        <img_64><![CDATA[http://images_site_url/image_name]]></img_64>
        <img_32><![CDATA[http://images_site_url/image_name]]></img_32>
      </images>
      <genre>
        <genreCode>253</genreCode>
        <name><![CDATA[Rock]]></name>
      </genre>
    </track>
    <available>13</available>
    <page>2</page>
  </tracks>
</response>

Sample Result: JSON
{
  "response": {
    "tracks": [{
      "trackCode": "3322008",
      "name": "For What It's Worth",
      "url": "http://contents_site_url/track_page",
      "downloadUrl": "http://download_site_url",
      "previewUrl": "http://preview_site_url",
      "embeddedPlayer" : Play.me player HTML object code,
      "fullStream": "1",
      "duration": "167",
      "publicationYear": "2009",
      "artist": {
        "artistCode": "1275",
        "name": "Placebo"
      },
      "album": {
        "albumCode": "3322004",
        "name": "Battle For The Sun"
      },
      "images": {
        "img_256": "http://images_site_url/image_name",
        "img_96": "http://images_site_url/image_name",
        "img_64": "http://images_site_url/image_name",
        "img_32": "http://images_site_url/image_name"
      },
      "genre": {
        "genreCode": "253",
        "name": "Rock"
      }
    },
    {
      "trackCode": "3322006",
      "name": "Ashtray Heart",
      "url": "http://contents_site_url/track_page",
      "downloadUrl": "http://download_site_url",
      "previewUrl": "http://preview_site_url",
      "embeddedPlayer" : Play.me player HTML object code,
      "fullStream": "1",
      "duration": "212",
      "publicationYear": "2009",
      "artist": {
        "artistCode": "1275",
        "name": "Placebo"
      },
      "album": {
        "albumCode": "3322004",
        "name": "Battle For The Sun"
      },
      "images": {
        "img_256": "http://images_site_url/image_name",
        "img_96": "http://images_site_url/image_name",
        "img_64": "http://images_site_url/image_name",
        "img_32": "http://images_site_url/image_name"
      },
      "genre": {
        "genreCode": "253",
        "name": "Rock"
      }
    }],
    "available": "13",
    "page": "2"
  }
}