Tinysong

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

Request an API Key

Please enter a valid e-mail address.
Please try again, the words did not match.
Please agree to the Terms of Service.
Your key has been generated and sent to the provided email address.
Terms of Service
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, appending a search term, and adding the API key. If we encounter an error you will recieve a JSON object with an error key.

Example

http://tinysong.com/method/query
?format=json&key=APIKey
/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?format=json&key=APIKey

Returns

"http:\/\/tinysong.com\/6OAB"
If a song is not found in our system, an empty set, [] 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.

Example

http://tinysong.com/b/Girl+Talk+
Ask+About+Me?format=json&key=APIKey

Returns

{
  "Url": "http:\/\/tinysong.com\/6OAB",
  "SongID": 13963,
  "SongName": "Ask About Me",
  "ArtistID": 77,
  "ArtistName": "Girl Talk",
  "AlbumID": 117512,
  "AlbumName": "Girl Talk"
}
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, but multiple 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. The default limit is five.

Example

http://tinysong.com/s/Beethoven
?format=json&limit=3&key=APIKey

Returns

[
  {
    "Url": "http:\/\/tinysong.com\/7Wm7",
    "SongID": 8815585,
    "SongName": "Moonlight Sonata",
    "ArtistID": 1833,
    "ArtistName": "Beethoven",
    "AlbumID": 258724,
    "AlbumName": "Beethoven"
  },
  {
    "Url": "http:\/\/tinysong.com\/6Jk3",
    "SongID": 564004,
    "SongName": "Fur Elise",
    "ArtistID": 1833,
    "ArtistName": "Beethoven",
    "AlbumID": 268605,
    "AlbumName": "Beethoven"
  },
  {
    "Url": "http:\/\/tinysong.com\/8We2",
    "SongID": 269743,
    "SongName": "The Legend Of Lil' Beethoven",
    "ArtistID": 7620,
    "ArtistName": "Sparks",
    "AlbumID": 204019,
    "AlbumName": "Sparks"
  }
]