ChartLyrics Lyric API

v1.0 Initial Release.

v1.1 Update, adding TrackId and TrackChecksum for future AddLyric function, Added
new function SearchLyricDirect which returns the first lyric or trackId directly
without having to make a second API call.

v1.2 Added AddLyric function and some minor improvements.

The ChartLyrics API supports both the SOAP and GET protocol. Allowing users to search
for lyrics using the artist name, song title or lyric text as search query.

SOAP API (beta)

Our Simple Object Access Protocol Application Programming Interface is available
to developers and end users who wish to use our database for their music project,
website or application.

Each call for artist and title combination can return a total of 25 possible songs
orderd by ChartLyrics rank.

Output Tag description

<SearchLyricResult> There search results, there will can to up to 25 instances
of this.

<TrackChecksum> Checksum required to add the lyric using the AddLyric function.

<TrackId> Id required to add the lyric using AddLyric function, The ID must
match the Checksum. Returns a positive integer when there is no lyric available.

<LyricChecksum> Checksum required to retrieve the song using GetLyric function.

<LyricId> Id required to retrieve the song using GetLyric function, The ID
must match the Checksum. Returns a positive integer when there is a lyric available.

<SongUrl> The URL of the song on the ChartLyrics website, If the lyric does
not exist this will show the Add Lyric link. Please encourage users to visit our
website to view/correct or add lyrics on the ChartLyrics website.

<ArtistUrl> The URL of the artist on the chartlyrics website.

<Song> The title of the song.

<SongRank> The ChartLyrics rank of the song on a 0 to 10 scale where 10 is
the most popular.

GetLyric & SearchLyricDirect

GetLyric retreives the lyric using the lyricId and lyricChecksum.

SearchLyricDirect retreives the lyric using the artist and song.

Input Tag description

For GetLyric

<lyricId> The lyric ID.

<lyricCheckSum> The lyric Checksum.

Both lyricId and lyricCheckSum are required. If the checksum does not match the
id and error message is returned.

For SearchLyricDirect

<Artist> The artist name, maximum 75 characters.

<Song> The song title, maximum 125 characters.

Both artist name and song title are needed. Stop-words are removed from the search
query, see the General section for the stop words.

Results from GetLyric and SearchLyricDirect are the same and described below.

Terms of Use

By using the ChartLyrics APIs you agree to these terms of use.

APIs are provided "as is," without any promises or guarantees of any sort.

The ChartLyrics APIs are free for non-commercial use. If you are a non-commercial
entity (eg. an individual) and you are not charging for your product, and the product
has no other commercial purpose, then you can use the ChartLyrics APIs. Otherwise,
you will require our written permission.

We require applications that make use of our APIs to encourage users to contribute
to our free community, Allow your users to add lyrics, correct lyrics or visits
to the lyrics page by using the links the APIs provide.

The ChartLyrics APIs are new, so we expect it to change over time. We will do our
best to maintain backwards compatibility between releases, but incompatible changes
may be required in the future.

Abuse or excessively frequent requests to ChartLyrics via the APIs may result in
the temporary or permanent suspension of your access to the APIs. ChartLyrics, in
its sole discretion, will determine abuse or excessive usage of the APIs.

ChartLyrics reserves the right at any time to modify or discontinue, temporarily
or permanently, access to the APIs (or any part thereof) with or without notice.

The ChartLyrics APIs are in Beta. No guarantees, no promises.

We reserve the right to change these terms.

Questions?

If you still have any question please regarding the API please
Contact Us.