API

Songsterr has an open Application Programming Interface (API for short). This means that anyone can write their own program to present public Songsterr data in new and different ways. The Songsterr API allows you to call methods that respond in REST style xml. Individual methods are detailed below.

Search

Example Request

http://www.songsterr.com/a/rest/Song.xml?method=search&pattern=Marley

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<Songs type = "Song">
  <Song>
    <id type = "integer">115</id>
    <title>No Woman No Cry</title>
    <artist type = "Artist">
      <id type = "integer">58</id>
      <name>Bob Marley</name>
    </artist>
  </Song>
  <Song>
    <id type = "integer">259</id>
    <title>Redemption Song</title>
    <artist type = "Artist">
      <id type = "integer">58</id>
      <name>Bob Marley</name>
    </artist>
  </Song>
</Songs>

Songs by Artists

Example Request

http://www.songsterr.com/a/rest/Song.xml?method=songsByArtists&artists=Metallica,"Led Zeppelin"

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<Songs type = "Song">
  <Song>
    <id type = "integer">19</id>
    <title>Enter Sandman</title>
    <artist type = "Artist">
      <id type = "integer">20</id>
      <name>Metallica</name>
    </artist>
  </Song>
  <Song>
    <id type = "integer">6716</id>
    <title>Stairway to Heaven (TSRTS live)</title>
    <artist type = "Artist">
      <id type = "integer">25</id>
      <name>Led Zeppelin</name>
    </artist>
  </Song>
</Songs>

Constructing URLs

You can construct URLs to a song or artist page once you know its id as returned by API calls above.

URL take the following format:

http://www.songsterr.com/a/wa/song?id={id}
http://www.songsterr.com/a/wa/artist?id={id}