NAME

XML::Amazon - Perl extension for getting information from Amazon

SYNOPSIS

        use XML::Amazon;
        
        my $amazon = XML::Amazon->new(token => AMAZON-ID, sak => Secret Access Key, locale => 'uk');
        
        my $item = $amazon->asin('0596101058');## ASIN access
        
        if ($amazon->is_success){
                print $item->title;
        }
        
        my $items = $amazon->search(keywords => 'Perl');## Search by 'Perl'
        
        foreach my $item ($items->collection){
        my $title = $item->title;
        utf8::encode($title);
        print $title . "¥n";
        }

DESCRIPTION

XML::Amazon provides a simple way to get information from Amazon. XML::Amazon can connect to US, JP, UK, FR, DE and CA.

USAGE

XML::Amazon->new(token => AMAZON-ID, associate => ASSOCIATE-ID, sak => Secret Access Key, locale => UK)

Creates a new empty XML::Amazon object. You should specify your Amazon Web Service ID and Secret Access Key (which can be obteined thorough http://www.amazon.com/gp/aws/registration/registration-form.html). You can also specify your locale (defalut: US; you can choose us, uk, jp, fr, de, ca) and your Amazon associate ID (default: webservices-20, which is Amazon default).

$XML_Amazon->asin(ASIN)

Returns an XML::Amazon::Item object whose ASIN is as given.

$XML_Amazon->search(keywords => 'Perl', page => '2', type => 'Books')

Returns an XML::Amazon::Collection object. i<type> can be Blended, Books, Music, DVD, etc.

$XML_Amazon->is_success

Returns 1 when successful, otherwise 0.

$XML_Amazon_Collection->total_results, $XML_Amazon_Collection->total_pages, $XML_Amazon_Collection->current_page

Returns as such.

$XML_Amazon_Collection->collection

Returns a list of XML::Amazon::Item objects.

$XML_Amazon_Item->title

$XML_Amazon_Item->made_by

Returns authors when the item is a book, and likewise.

$XML_Amazon_Item->publisher

$XML_Amazon_Item->url

$XML_Amazon_Item->image(size)

Returns the URL of the cover image. size can be s, m, or l.

$XML_Amazon_Item->price

SEE ALSO

AUTHOR

Yusuke Sugiyama, <ally@blinkingstar.net>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Yusuke Sugiyama

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

cpanm XML::Amazon

perl -MCPAN -e shell
install XML::Amazon