album.searchByName

Description: 

Searches albums by 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 that must appears within the album title, separated by a blank space [O].
Note that API searches for titles that contains all words. The order is not taken into account. If no query value is provided, no filtering is executed (i.e. it searches '*')
page : result page
step : number of elements within the page

Return values: 

List of album digests.
The number of albums whose title contains the query string.
The current result page


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

Sample Result: XML
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <albums>
    <album>
      <albumCode>1050592</albumCode>
      <name><![CDATA[It Is Time For A Love Revolution]]></name>
      <url><![CDATA[http://contents_site_url/album_page]]></url>
      <numTracks>16</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>909</artistCode>
        <name><![CDATA[Lenny Kravitz]]></name>
      </artist>
    </album>
    <album>
      <albumCode>2965290</albumCode>
      <name><![CDATA[Have I Told You Lately That I Love You]]></name>
      <url><![CDATA[http://contents_site_url/album_page]]></url>
      <numTracks>20</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>2005</artistCode>
        <name><![CDATA[Various Artists]]></name>
      </artist>
    </album>
    <available>1000</available>
    <page>2</page>
  </albums>

</response>

Sample Result: JSON
{
  "response": {
    "albums": [

    {
      "albumCode": "1050592",
      "name": "It Is Time For A Love Revolution",
      "url": "http://contents_site_url/album_page",
      "numTracks": "16",
      "publicationYear": "2008",
      "images": {
      "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": "909",
        "name": "Lenny Kravitz"
      }
    },

    {
      "albumCode": "2965290",
      "name": "Have I Told You Lately That I Love You",
      "url": "http://contents_site_url/album_page",
      "numTracks": "20",
      "publicationYear": "2008",
      "images": {
      "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": "2005",
        "name": "Various Artists"
      }
    }
    ],

    "available": "1000",
    "page": "2"
  }
}