Tinysong

Tinysong API

Tinysong has a simple RESTful API that makes available search and Tinysong URL generation.

There are three ways to use the API. Each way returns a Tinysong URL, however some return more information. The three different API "methods" are referred to by /a/, /b/, and /s/.

Each of these API methods are called by choosing a method and appending a search term.

Example

http://tinysong.com/method/Search+Terms

/a/

This method returns a single Tinysong link. Behind-the-scenes, Tinysong performs a search using your supplied song and artist name terms, then returns the 1st result found, as a Tinysong link.

Example

http://tinysong.com/a/Girl+Talk+Ask+About+Me

Returns

http://tinysong.com/320

If a song is not found in our system, NSF; will be returned.

/b/

This method performs the same search as the /a/ method, but also returns additional meta-information about the Tinysong link generated.

Returned Elements

tinysong link; songID; songName; artistID; artistName; albumID; albumName; Grooveshark link

Example

http://tinysong.com/b/Girl+Talk+Ask+About+Me

Returns

http://tinysong.com/320; 13963; Ask About Me; 77; Girl Talk; 117512; Night Ripper; http://listen.grooveshark.com/song/Ask_About_Me/13963

If you're just doing a simple Tinysong integration you can ignore songID, artistID, and albumID.

/s/

This third method performs a search just as the other two methods do, except up to six results are returned, in the same format as outlined above for the /b/ method. If you want to limit the number of results returned, say you only want three results returned, for example, you can append a 'limit' parameter to the url. The minimum value for the limit parameter is one, while the maximum is 32.

Example

http://tinysong.com/s/Beethoven?limit=3

Returns

http://tinysong.com/DjY; 564004; Fur Elise; 1833; Beethoven; 268605; The Best Of Beethoven; http://listen.grooveshark.com/song/Fur_Elise/564004
http://tinysong.com/N7c; 716886; Moonlight Sonata; 1833; Beethoven; 168699; Ludwig Van Beethoven; http://listen.grooveshark.com/song/Moonlight_Sonata/716886
http://tinysong.com/29V; 564008; Moonlight; 1833; Beethoven; 268605; The Best Of Beethoven; http://listen.grooveshark.com/song/Moonlight/564008