stereomood API

search

returns a list of a song matching the specified query.


url:
http://www.stereomood.com/api/search.format

formats:
xml, json

requires authentication (about authentication):
true

rate limiting (about rate limiting):
true

parameters:

  • q. the text to search for.
  • type. mood, activity or site.
  • limit. an integer used to limit the number of results returned per page. the default is 20 (Max 100).
  • page.the page number to fetch.


sample request:
http://www.stereomood.com/api/search.xml?q=happy&type=mood


xml sample response:

<?xml version="1.0" encoding="UTF-8"?>
<search>
  <total>total track number</total>
  <page>current page</page>
  <limit>current limit</limit>
  <total_pages>number of pages</total_pages>
  <songs>
    <song>
         <id>id of the song</id>
         <title>song title</title>
         <artist>song artist</artist>
         <album>song album</album>
         <url>song page url</url>
         <image_url>song image</image_url>
         <audio_url>url of the audio file</audio_url>
         <post_url>url of the blog post</post_url>
    </song>
    ...
  </songs>
</search>

Last edited by Stereomood Tech Team, March 29, 2010

create an application