Tuesday, August 08, 2006

Introducing the thingTitle API

As noticed below, the Mashing up the Library competition is drawing to a close. LibraryThing tried to stoke things by releasing its thingISBN API, which takes an ISBN and returns ISBNs for all the other editions. Here's one more API. Go do something interesting with it, eh?

thingTitle. Announcing another simple LibraryThing API. Feed it a title and it will return all the ISBNs from the most likely LibraryThing "work," the LibraryThing title and a link to the LibraryThing work page.

It should prove useful for people who have uncontrolled, ratty or ISBN-less data. I plan to use it to mine the syllabi and playlists at H20. A company like IMDb could use it to provide ISBN links for movies "based on" a novel, or dating services for their members' favorite books—it works well with The Unbearable Lightness of Being. (Note, however, the no-commerial-use license.)

Examples:
http://www.librarything.com/api/thingTitle/The Hobbit
http://www.librarything.com/api/thingTitle/Jonathan Strange
http://www.librarything.com/api/thingTitle/The Curious Incident

It's flexible with how you do spaces:
http://www.librarything.com/api/thingTitle/The Hobbit
http://www.librarything.com/api/thingTitle/The+Hobbit
http://www.librarything.com/api/thingTitle/The_Hobbit
It's not perfect. It can't read your mind and it learns toward popular things. If you give it "The curious incident" it will guess you mean Mark Haddon's The Curious Incident of the Dog in the Night-time, owned by over 2,000 LibraryThing members, not The Curious Incident Of The WMD In Iraq (4 members), or the parody The Curious Incident of the Dog in the Nightdress (1 member).

The output is simplicity itself:
<idlist>
<title>The magician's assistant</title>
<link>http://www.librarything.com/catalog/6009</link>
<isbn>0156006219</isbn>
<isbn>0151002630</isbn>
<isbn>1841150029</isbn>
<isbn>1857028139</isbn>
<isbn>1857028155</isbn>
<license>By using this service you agree to its license.</license>
</idlist>
Note that it doesn't always return a title. If LibraryThing only knows the title from Amazon data, it omitts it per the Amazon TOS.

Improvements. At present, it only returns one result. It could return many, in descending order of likelihood. Nor does it accept any other hints, such as the author name. It could accept these, and take them into account.

License. As with thingISBN, thingTitle is available for non-commercial only. (Commercial use requires our written permission.) You can only make 1 request/second, and if you plan to hit it more than 1,000 times/day for an extended period, you must notify us of what you're doing. In fact, we'd love to hear anyway. Needless to say, it's provided "as is" with no guarantee whatsoever. If you use thingTitle to run a lathe, we are not responsible for missing digits.

7 Comments:

Anonymous Anonymous said...

Tim,

I'm not into the coding stuff, but couldn't you use this functionality to improve the universal import tool so that it doesn't need ISBNs. My dad's got a big Excel spready with his whole library in, but just titles, no ISBNs- I'd love to get an approximation in to LT without rekeying everything.

TCarter

8/12/2006 4:04 PM  
Anonymous Anonymous said...

This comment has been removed by a blog administrator.

9/04/2006 1:17 PM  
Anonymous Anonymous said...

This comment has been removed by a blog administrator.

9/04/2006 1:17 PM  
Anonymous Anonymous said...

This comment has been removed by a blog administrator.

9/04/2006 1:17 PM  
Blogger Unknown said...

Your links, such as http://www.librarything.com/api/thingTitle/The Hobbit , are returning empty pages. Temporary glitch?

5/07/2007 3:22 PM  
Anonymous Anonymous said...

Aye, this doesn't appear to be working ?

7/23/2007 7:27 AM  
Anonymous Anonymous said...

Still not working :(

3/15/2009 3:37 PM  

Post a Comment

<< Home