/ 
WWW-Scraper-ISBN-ISBNdb_Driver-0.11
River stage one • 1 direct dependent • 1 total dependent
/ WWW::Scraper::ISBN::ISBNdb_Driver

NAME

WWW::Scraper::ISBN::ISBNdb_Driver - Search driver for the isbndb.com online book catalog

SYNOPSIS

use WWW::Scraper::ISBN;
my $scraper = new WWW::Scraper::ISBN();
$scraper->drivers( qw/ ISBNdb / );
$WWW::Scraper::ISBN::ISBNdb_Driver::ACCESS_KEY = 'xxxx'; # Your isbndb.com access key

my $isbn = '0596101058';
my $result = $scraper->search( $isbn );

if( $result->found ) {
  my $book = $result->book;
  print "ISBN: ",      $book->{isbn},      "\n";
  print "Title: ",     $book->{title},     "\n";
  print "Author: ",    $book->{author},    "\n";
  print "Publisher: ", $book->{publisher}, "\n";
}

DESCRIPTION

This is a WWW::Scraper::ISBN driver that pulls data from http://www.isbndb.com. Consult WWW::Scraper::ISBN for usage details.

METHODS

search()

Given an ISBN, will attempt to find the details via the ISBNdb.com API. If a valid result is returned, the following fields are returned via the book hash:

isbn          (now returns isbn13)
isbn10        
isbn13
ean13         (industry name)
title
author
dewey
book_link
publisher
pubdate
binding       (if known)
pages         (if known)
weight        (if known) (in grammes)
width         (if known) (in millimetres)
height        (if known) (in millimetres)
depth         (if known) (in millimetres)
description   (if known)

The following fields have now been deprecated:

location
year          # now pubdate
_source_url   # now book_link

THE ACCESS KEY

To use this driver you will need to obtain an access key from isbndb.com. It is free to sign-up to isbndb.com, and once registered, you can request an API key.

To set the access key in the driver, within your application you will need to set the following, after the driver has been loaded, and before you perform a search.

$WWW::Scraper::ISBN::ISBNdb_Driver::ACCESS_KEY = 'xxxx';

You can also set the key in the ISBNDB_ACCESS_KEY environment variable.

Alternatively, you can create a '.isbndb' configuration file in your home directory, which should only contain the key itself.

Reference material for developers can be found at http://isbndb.com/api/v2/docs.

SEE ALSO

WWW::Scraper::ISBN

BUGS

Please report any bugs or feature requests to bug-www-scraper-isbn-isbndb_driver at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Scraper-ISBN-ISBNdb_Driver. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

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

perldoc WWW::Scraper::ISBN::ISBNdb_Driver

You can also look for information at:

AUTHOR

2006-2013 David J. Iberri, C<< <diberri at cpan.org> >>
2013-2014 Barbie, E<lt>barbie@cpan.orgE<gt>

COPYRIGHT AND LICENSE

Copyright 2004-2013 by David J. Iberri
Copyright 2013-2014 by Barbie

This distribution is free software; you can redistribute it and/or
modify it under the Artistic Licence v2.