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. We also support json and plist - just substitute ".xml" with ".json" or ".plist" Individual methods are detailed below.

Search

Example Request

http://www.songsterr.com/a/ra/songs.xml?pattern=Marley

Example Response

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

Songs by Artists

Example Request

http://www.songsterr.com/a/ra/songs/byartists.xml?artists=Metallica,"Led%20Zeppelin"

Example Response

<?xml version="1.0" encoding="UTF-8"?> 
<NSArray> 
  <Song type="Song" id="19"> 
    <title>Enter Sandman</title> 
    <artist type="Artist" id="20"> 
      <nameWithoutThePrefix>Metallica</nameWithoutThePrefix> 
      <useThePrefix>false</useThePrefix> 
      <name>Metallica</name> 
    </artist> 
  </Song> 
  <Song type="Song" id="20"> 
    <title>Fade To Black</title> 
    <artist type="Artist" id="20"/> 
  </Song> 
  <Song type="Song" id="27"> 
    <title>Stairway to Heaven</title> 
    <artist type="Artist" id="25"> 
      <nameWithoutThePrefix>Led Zeppelin</nameWithoutThePrefix> 
      <useThePrefix>false</useThePrefix> 
      <name>Led Zeppelin</name> 
    </artist> 
  </Song> 
  <Song type="Song" id="154"> 
    <title>Going to California</title> 
    <artist type="Artist" id="25"/> 
  </Song> 
</NSArray>

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}

Best Match URL

If you have artist name and song title and want to construct url to the tab page on Songsterr, you can use the following format:

http://www.songsterr.com/a/wa/bestMatchForQueryString?s={song title}&a={artist name}, 

e.g.:

http://www.songsterr.com/a/wa/bestMatchForQueryString?s=Wonderwall&a=Oasis

if you want to link to tab with bass track selected by default, add "inst=bass" url parameter:

http://www.songsterr.com/a/wa/bestMatchForQueryString?s=Come+Together&a=Beatles&track=bass

Need more?

Need access to tab data or audio? Email us an overview of your project using the "Contact" link in the footer.