|
API Application Programming Interface is available to anyone who wishes to use our database for their own music project, website or program. If you currently use the web to search out lyrics or use code tricks to access other lyrics websites to display relevant lyrics text for your content you can now have a reliable source without the hassle. Documentation Download example code for php here Please use the weekly user ID key below for testing: (good all this week, Mon-Sun) Calls are made using the following URL format: http://lyricsfly.com/api/api.php?i=[USER ID]&a=[ARTIST]&t=[TITLE] For both artist variable and title variable, replace all special and international characters with "%". All API calls return an XML document. The following is an example of the output: <?xml version="1.0" encoding="utf-8"?> -<start> -<sg> <cs>14eb6fba81</cs> <id>1438</id> <ar>U2</ar> <tt>Beautiful Day</tt> <al>All that you can't leave behind</al> -<tx> . . . . . Lyrics provided by lyricsfly.com [br] </tx> </sg> </start> Each call can return a total of 3 possible titles. Because of some album duplicates such as live performances as well as re-releases, we give you an option to pick the best result that suits your needs. Tag description <sg> - song <cs> - checksum (for original URL link back construction) <id> - song ID in the database (for original URL link back construction) <ar> - artist name <tt> - title of the song <al> - album name <tx> - lyrics text separated by [br] for line break (replace with <br>) Editing lyrics In order to provide your users with ability to edit lyrics you will have to link back to us. This is done by sending the checksum and song ID to our correction form with the following URL format: http://lyricsfly.com/search/correction.php?[CHECKSUM]&id=[SONG ID] Correction form is seamless and works directly inside of a browser, taking into account for an already in progress correction, all without the need to sign up. By helping us you will be helping all of your users with an updated and most correct lyrics available. Flash cross domain Crossdomain xml file is located at: http://lyricsfly.com/api/crossdomain.xml It allows access from all sites. Content Quality Most of our lyric text is dead on correct. Submissions from users are looked at very closely and corrected if needed. However, most of our titles are crawled and cached by our spiders which are selectively programmed to weed out and collect only the highest quality content. Without going into details and giving out secrets to our proprietary methods, lets just say the only thing we skip on is the Gracenote license... the content is a 100% match. Original contributors of the CDDB would have been proud. Enjoy! Requirements for permanent user ID key 1. Proof that your code is working with the weekly key. The reason why we provide the weekly key is so that you can start your work immediately and just replace one line of code with the new key once everything is completed. In order to create a fast and responsive API system we save the permanent keys only for those who will put them to use. 2. Website and domain name for your project. We need to establish your presence on the web. Personal projects for individual use will be rejected unless they are put to use for general public. Please use the weekly key for educational purposes. You can obtain a new key on this page every Monday at 12:00am 3. Verify your identity based on your request. The best way is to send us the request directly from the domain's mailbox. If you don't have mail setup, just make a custom page on the site or think of another way. This prevents other people from requesting permanent keys for your project. 4. Make sure your email does not block webmaster at lyricsfly.com Add our domain to your safe senders list. Do what you need to your mail client and/or the server to make sure our mail goes through. No matter how many times you ask us for the permanent user ID key, you will not get it if your mail server or your mail client filters our mail to you. Once your project meets the above requirements, please contact us us for a permanent user ID key which will be assigned specifically to your project. There are no limits on how many keys you can get as long as each fulfills the above. License Each lyrics text fed from our database should have our domain name trademark recognition with preferable link to the original song or its' correction form. Besides intentional abuse, there are no restriction in using our database nor in combination with others (mashup). We welcome commercial, shareware as well as open source freeware products without royalty payments. We do however reserve the right to deny access based on the above mentioned circumstances or requirements. We have gathered this database from everyday web users like you and we think lyrics to all songs should be freely available without any restrictions. Song lyrics performed by an artist can be interpreted in many ways. No label, and sometimes not even the inside of an album cover can carry the exact reflection of this artistic expression. Here at lyricsfly... people decide. |