Tuesday, September 05, 2006

How to integrate with LibraryThing

The other half of the mashup!

As detailed on the main blog, LibraryThing is now integrating with swap sites.

Any swap site can do it, if they follow these simple steps. These are ideals, and negotiable. Just drop Tim a line and let's talk.
  1. Provide feeds for books available and books wanted. For format see http://www.bookmooch.com/api/ under all_inventory.txt and all_wishlist.txt. Provide ISBNs where you can, ASINs where necessary. Provide only one entry per ISBN, taking care not to have both upper and lower-case versions. The sort order is not important.
  2. Provide model URLs for the detail page of a book, getting a book and giving a book. (See note on "works" below.) Getting and giving should route a NEW user through sign-up before returning them to their chosen page.
  3. Provide a logo no larger than 250x50.
  4. Allow users to add received books to LibraryThing, using http://www.librarything.com/blog/2006/08/add-to-librarything-from-anywhere.php.
  5. Provide a link to LibraryThing on your book detail page. Use http://www.librarything.com/blog/2006/07/new-ways-to-link-to-book.php.

On works: LibraryThing doesn't actually go by ISBN. It goes by "works." Works are collections of ISBNs, mostly combined by users. So, Harry Potter in the UK paperback is the same "work" as Harry Potter in the US hardcover and even a Finnish translation of Harry Potter. So, when LibraryThing reads your feed it will interpret it that way. This means that, ideally, when making URLs on your site—LibraryThing's book detail link, and certainly its give and get book links—you should be able to accept a NUMBER of ISBNs corresponding to all the ISBNs in a LibraryThing "work." Ideally, these should be separated by commas.
If you want to use LibraryThing's concept of work—an extremely powerful thing--you can use LibraryThing's thingISBN service. Unfortunately, this is non-commercial use only, so you need to talk to Tim about it.

That's it!

4 Comments:

Blogger Abby said...

That's the scariest action-figure mash-up I've ever seen. (And I've seen two, now). Are we trying to scare Nancy Pearl away? Didn't we want her to talk about us? And in a positive light?

:)

9/05/2006 10:32 PM  
Blogger Tim said...

You kidding me? She's a badass librarian, taking no guff from the Patriot Act!

Can we get a David Pogue figure?

9/05/2006 11:04 PM  
Blogger Abby said...

The real question is, what would you mash David Pogue up with? (and at what point does it border on journalist voodoo?)

9/05/2006 11:07 PM  
Blogger Tim said...

How much would it cost to make an Abby action figure? ("With life-like shushing action!" or at least a French press accessory.) Then maybe we get Nancy and Blackbeard to threaten and tempt you with coffee and a blunderbuss, and you'll move to Maine.

9/06/2006 12:27 AM  

Post a Comment

<< Home