/ 
WebService-LibraryThing-ThingISBN-0.503
River stage zero No dependents
++
/ WebService::LibraryThing::ThingISBN

NAME

WebService::LibraryThing::ThingISBN - Get ISBNs for all editions of a book

VERSION

Version 0.503

SYNOPSIS

This is a Perl interface to the LibraryThing social cataloging website's thingISBN web service, which "takes an ISBN and returns a list of ISBNs from the same 'work' (ie., other editions and translations)." The web service is freely available for noncommercial use, per the terms at http://www.librarything.com/api.

    use WebService::LibraryThing::ThingISBN qw( thing_isbn_list );
    my @alternate_isbns = thing_isbn_list( isbn => '0060987049' );

EXPORT

Exports nothing by default. thing_isbn_list can be optionally exported:

    use WebService::LibraryThing::ThingISBN qw( thing_isbn_list );

FUNCTIONS

thing_isbn_list

This function takes a single ISBN as an argument, and queries LibraryThing's thingISBN web service to get a list of ISBNs corresponding to other editions of the same book, based on LibraryThing's work definitions.

ISBNs can be either strings (hyphenated or unhyphenated; ISBN-10 or ISBN-13) or Business::ISBN objects.

thing_isbn_list returns a list of unhyphenated ISBN strings. If there's an error, it returns an empty list.

Per LibraryThing's API terms of use, requests are limited to run no more than once per second. (Users hitting the service over 1000 times a day are required to notify LibraryThing.)

AUTHOR

Anirvan Chatterjee, <anirvan at cpan.org>

BUGS

Please report any bugs or feature requests to bug-webservice-librarything-thingisbn at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-LibraryThing-ThingISBN. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

Bug reports about the underlying thingISBN API should be sent to LibraryThing. Contact them at http://www.librarything.com/contact.

SUPPORT

The thingISBN API is documented at:

You can find documentation for this module with the perldoc command.

    perldoc WebService::LibraryThing::ThingISBN

You can also look for information at:

ACKNOWLEDGEMENTS

Thanks to LibraryThing for making thingISBN available.

COPYRIGHT & LICENSE

Copyright 2009 Anirvan Chatterjee.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

Use of the LibraryThing thingISBN API is governed by the terms of use listed at http://www.librarything.com/api.