stereomood API

listen – POST

adds a listen to the selected song for the authenticated user.

Submission criteria:

  1. the track must be submitted once it has finished playing.
  2. the track must have been played for a duration of at least 240 seconds or half the track’s total length, whichever comes first. skipping or pausing the track is irrelevant as long as the amount has been played.

url:
http://www.stereomood.com/api/song/listen/id.format or http://www.stereomood.com/api/song/listen.format

HTTP request method:
POST

formats:
xml, json

requires authentication (about authentication):
true

rate limiting (about rate limiting):
false

parameters:

  • id. the id of the song.

sample request:
http://www.stereomood.com/api/song/listen/12345.json
or http://www.stereomood.com/api/song/listen.xml?id=12345

xml sample response:

<?xml version="1.0" encoding="UTF-8"?>
<hash>
    <request>/api/listen/song/12345.xml</request>
    <message>listen added</message>
</hash>

Last edited by Stereomood Tech Team, July 5, 2010

create an application