album.search

Description: 

Searches albums by author and title by a query string: returns a list made up by albums whose author or title matches the query string. Note that words within query string are connected by AND, so that all of them must appear within the album title or the album author's name. This implies that sarching with query string query=nirvana nevermind will give an empty result as Nirvana is the author's name and Nevermind the album title.
From: v. 1.0


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

Return values: 

List of album entities.


Sample call
http://api.playme.com/album.search?query=beatles&page=2&step=2&country=us

Sample Result: XML
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <albums>

    <album>
      <albumCode>2378098</albumCode>
      <name><![CDATA[Beatles Songs Unplugged]]></name>
      <url><![CDATA[http://contents_site_url/album_page]]></url>
      <numTracks>18</numTracks>
      <publicationYear>1994</publicationYear>
      <images>
        <img_256><![CDATA[http://images_site_url/image_name]]></img_256>
        <img_128><![CDATA[http://images_site_url/image_name]]></img_128>
        <img_64><![CDATA[http://images_site_url/image_name]]></img_64>
        <img_32><![CDATA[http://images_site_url/image_name]]></img_32>
      </images>
      <artist>
        <artistCode>105277</artistCode>
        <name><![CDATA[The Beatles Revival Band]]></name>
      </artist>
    </album>

    <album>
      <albumCode>949147</albumCode>
      <name><![CDATA[Savage Young Beatles]]></name>
      <url><![CDATA[http://contents_site_url/album_page]]></url>
      <numTracks>8</numTracks>
      <publicationYear>2008</publicationYear>

      <images>
        <img_256><![CDATA[http://images_site_url/image_name]]></img_256>
        <img_128><![CDATA[http://images_site_url/image_name]]></img_128>
        <img_64><![CDATA[http://images_site_url/image_name]]></img_64>
        <img_32><![CDATA[http://images_site_url/image_name]]></img_32>
      </images>
      <artist>
        <artistCode>57145</artistCode>
        <name><![CDATA[Savage Young Beatles, Tony Sheridan]]></name>
      </artist>
    </album>

    <available>112</available>

    <page>2</page>

  </albums>
</response>

Sample Result: JSON
{
  "response": {
    "albums": [{
      "albumCode": "2378098",
      "name": "Beatles Songs Unplugged",
      "url": "http://contents_site_url/album_page",
      "numTracks": "18",
      "publicationYear": "1994",
      "images": {
        "img_256": "http://images_site_url/image_name",
        "img_128": "http://images_site_url/image_name",
        "img_64": "http://images_site_url/image_name",
        "img_32": "http://images_site_url/image_name"
      },
      "artist": {
        "artistCode": "105277",
        "name": "The Beatles Revival Band"
      }
    },
    {
      "albumCode": "949147",
      "name": "Savage Young Beatles",
      "url": "http://contents_site_url/album_page",
      "numTracks": "8",
      "publicationYear": "2008",
      "images": {
        "img_256": "http://images_site_url/image_name",
        "img_128": "http://images_site_url/image_name",
        "img_64": "http://images_site_url/image_name",
        "img_32": "http://images_site_url/image_name"
      },
      "artist": {
        "artistCode": "57145",
        "name": "Savage Young Beatles, Tony Sheridan"
      }
    }

    ],
    "available": "112",
    "page": "2"     
    }
}