NAME

Net::Amazon::Request - Baseclass for requests to Amazon's web service


SYNOPSIS

    my $req = Net::Amazon::Request::XXX->new(
                     [ type  => 'Large', ]
                     [ page  => $start_page, ]
                     [ mode  => $mode, ]
                     [ offer => 'All', ]
                     [ sort => $sort_type, ]
    );


DESCRIPTION

Don't use this class directly, use derived classes (like Net::Amazon::Request::ASIN, Net::Amazon::Request::Wishlist etc.) instead to specify the type of request and its parameters.

However, there's a bunch of parameters to the constructor that all request types have in common, here they are:

type
Defaults to Large, but can also be set to Medium, or Small.
Large
The Large type provides everything in Medium as well as music track information, customer reviews, similar products, offers, and accessory data, i.e. the kitchen sink.

Medium
The Medium type provides everything in Small as well as sales rank, editorial reviews, and image URLs.

Small
The Small type provies ASIN, product title, creator (author, artist, etc.), product group, URL, and manufacturer.

mode
Defaults to books, but can be set to other catalog values.

page
Defaults to 1, but can be set to a different number to start with a different result page. Used in conjunction with the max_pages parameter of the Net::Amazon object. page is the offset, max_pages is the maximum number of pages pulled in starting at page.

sort
Defaults to salesrank, but search results can be sorted in various ways, depending on the type of product returned by the search. Search results may be sorted by the following criteria:

Consult the Net::Amazon::Request::Sort manpage for details.

offer
To receive values for the fields CollectibleCount, NumberOfOfferings, UsedCount, specify offer => "All".


SEE ALSO

Net::Amazon, Net::Amazon::Response, Net::Amazon::Property, Net::Amazon::Request, Net::Amazon::Property::Book, Net::Amazon::Property::VideoGames, Net::Amazon::Property::CE, Net::Amazon::Property::Music, Net::Amazon::Property::Software, Net::Amazon::Property::DVD, Net::Amazon::Response::Blended, Net::Amazon::Response::Manufacturer, Net::Amazon::Response::Seller, Net::Amazon::Response::EAN, Net::Amazon::Response::Director, Net::Amazon::Response::ISBN, Net::Amazon::Response::BrowseNode, Net::Amazon::Response::Power, Net::Amazon::Response::Wishlist, Net::Amazon::Response::Exchange, Net::Amazon::Response::Publisher, Net::Amazon::Response::MusicLabel, Net::Amazon::Response::Keyword, Net::Amazon::Response::ASIN, Net::Amazon::Response::Title, Net::Amazon::Response::UPC, Net::Amazon::Response::Artist, Net::Amazon::Response::Similar, Net::Amazon::Response::Actor, Net::Amazon::Response::Author, Net::Amazon::Response::TextStream, Net::Amazon::Attribute::ReviewSet, Net::Amazon::Attribute::Review, Net::Amazon::Validate::ItemSearch, Net::Amazon::Validate::Type, Net::Amazon::Validate::Type::SellerListingSearch, Net::Amazon::Validate::Type::CartModify, Net::Amazon::Validate::Type::ItemSearch, Net::Amazon::Validate::Type::CartCreate, Net::Amazon::Validate::Type::TagLookup, Net::Amazon::Validate::Type::SimilarityLookup, Net::Amazon::Validate::Type::BrowseNodeLookup, Net::Amazon::Validate::Type::CustomerContentSearch, Net::Amazon::Validate::Type::SellerLookup, Net::Amazon::Validate::Type::SellerListingLookup, Net::Amazon::Validate::Type::CustomerContentLookup, Net::Amazon::Validate::Type::ListLookup, Net::Amazon::Validate::Type::CartAdd, Net::Amazon::Validate::Type::TransactionLookup, Net::Amazon::Validate::Type::ListSearch, Net::Amazon::Validate::Type::CartGet, Net::Amazon::Validate::Type::ItemLookup, Net::Amazon::Validate::Type::CartClear, Net::Amazon::Validate::Type::Help, Net::Amazon::Validate::ItemSearch::jp::Sort, Net::Amazon::Validate::ItemSearch::jp::Manufacturer, Net::Amazon::Validate::ItemSearch::jp::ISPUPostalCode, Net::Amazon::Validate::ItemSearch::jp::EAN, Net::Amazon::Validate::ItemSearch::jp::Keywords, Net::Amazon::Validate::ItemSearch::jp::Director, Net::Amazon::Validate::ItemSearch::jp::PostalCode, Net::Amazon::Validate::ItemSearch::jp::AudienceRating, Net::Amazon::Validate::ItemSearch::jp::Availability, Net::Amazon::Validate::ItemSearch::jp::MaximumPrice, Net::Amazon::Validate::ItemSearch::jp::BrowseNode, Net::Amazon::Validate::ItemSearch::jp::Power, Net::Amazon::Validate::ItemSearch::jp::Conductor, Net::Amazon::Validate::ItemSearch::jp::Composer, Net::Amazon::Validate::ItemSearch::jp::DeliveryMethod, Net::Amazon::Validate::ItemSearch::jp::Magazines, Net::Amazon::Validate::ItemSearch::jp::Performer, Net::Amazon::Validate::ItemSearch::jp::Count, Net::Amazon::Validate::ItemSearch::jp::Publisher, Net::Amazon::Validate::ItemSearch::jp::State, Net::Amazon::Validate::ItemSearch::jp::MusicLabel, Net::Amazon::Validate::ItemSearch::jp::Brand, Net::Amazon::Validate::ItemSearch::jp::MinimumPrice, Net::Amazon::Validate::ItemSearch::jp::ItemPage, Net::Amazon::Validate::ItemSearch::jp::Title, Net::Amazon::Validate::ItemSearch::jp::Condition, Net::Amazon::Validate::ItemSearch::jp::MerchantId, Net::Amazon::Validate::ItemSearch::jp::Artist, Net::Amazon::Validate::ItemSearch::jp::Actor, Net::Amazon::Validate::ItemSearch::jp::Author, Net::Amazon::Validate::ItemSearch::jp::Orchestra, Net::Amazon::Validate::ItemSearch::jp::TextStream, Net::Amazon::Validate::ItemSearch::jp::Format, Net::Amazon::Validate::ItemSearch::us::Sort, Net::Amazon::Validate::ItemSearch::us::Manufacturer, Net::Amazon::Validate::ItemSearch::us::Browsenode, Net::Amazon::Validate::ItemSearch::us::Keywords, Net::Amazon::Validate::ItemSearch::us::Director, Net::Amazon::Validate::ItemSearch::us::Neighborhood, Net::Amazon::Validate::ItemSearch::us::PostalCode, Net::Amazon::Validate::ItemSearch::us::AudienceRating, Net::Amazon::Validate::ItemSearch::us::Availability, Net::Amazon::Validate::ItemSearch::us::MaximumPrice, Net::Amazon::Validate::ItemSearch::us::BrowseNode, Net::Amazon::Validate::ItemSearch::us::Power, Net::Amazon::Validate::ItemSearch::us::Conductor, Net::Amazon::Validate::ItemSearch::us::Composer, Net::Amazon::Validate::ItemSearch::us::Magazines, Net::Amazon::Validate::ItemSearch::us::Performer, Net::Amazon::Validate::ItemSearch::us::City, Net::Amazon::Validate::ItemSearch::us::Count, Net::Amazon::Validate::ItemSearch::us::Publisher, Net::Amazon::Validate::ItemSearch::us::State, Net::Amazon::Validate::ItemSearch::us::MusicLabel, Net::Amazon::Validate::ItemSearch::us::Brand, Net::Amazon::Validate::ItemSearch::us::MinimumPrice, Net::Amazon::Validate::ItemSearch::us::Keyword, Net::Amazon::Validate::ItemSearch::us::ItemPage, Net::Amazon::Validate::ItemSearch::us::Title, Net::Amazon::Validate::ItemSearch::us::Condition, Net::Amazon::Validate::ItemSearch::us::UPC, Net::Amazon::Validate::ItemSearch::us::MerchantId, Net::Amazon::Validate::ItemSearch::us::Artist, Net::Amazon::Validate::ItemSearch::us::MPAARating, Net::Amazon::Validate::ItemSearch::us::Actor, Net::Amazon::Validate::ItemSearch::us::Author, Net::Amazon::Validate::ItemSearch::us::Orchestra, Net::Amazon::Validate::ItemSearch::us::TextStream, Net::Amazon::Validate::ItemSearch::us::Format, Net::Amazon::Validate::ItemSearch::ca::Sort, Net::Amazon::Validate::ItemSearch::ca::Manufacturer, Net::Amazon::Validate::ItemSearch::ca::EAN, Net::Amazon::Validate::ItemSearch::ca::Keywords, Net::Amazon::Validate::ItemSearch::ca::Director, Net::Amazon::Validate::ItemSearch::ca::AudienceRating, Net::Amazon::Validate::ItemSearch::ca::MaximumPrice, Net::Amazon::Validate::ItemSearch::ca::BrowseNode, Net::Amazon::Validate::ItemSearch::ca::Power, Net::Amazon::Validate::ItemSearch::ca::Conductor, Net::Amazon::Validate::ItemSearch::ca::Composer, Net::Amazon::Validate::ItemSearch::ca::Count, Net::Amazon::Validate::ItemSearch::ca::Publisher, Net::Amazon::Validate::ItemSearch::ca::MusicLabel, Net::Amazon::Validate::ItemSearch::ca::Brand, Net::Amazon::Validate::ItemSearch::ca::MinimumPrice, Net::Amazon::Validate::ItemSearch::ca::ItemPage, Net::Amazon::Validate::ItemSearch::ca::Title, Net::Amazon::Validate::ItemSearch::ca::Condition, Net::Amazon::Validate::ItemSearch::ca::MerchantId, Net::Amazon::Validate::ItemSearch::ca::Artist, Net::Amazon::Validate::ItemSearch::ca::Actor, Net::Amazon::Validate::ItemSearch::ca::Author, Net::Amazon::Validate::ItemSearch::de::Sort, Net::Amazon::Validate::ItemSearch::de::Manufacturer, Net::Amazon::Validate::ItemSearch::de::ISPUPostalCode, Net::Amazon::Validate::ItemSearch::de::EAN, Net::Amazon::Validate::ItemSearch::de::Keywords, Net::Amazon::Validate::ItemSearch::de::Director, Net::Amazon::Validate::ItemSearch::de::PostalCode, Net::Amazon::Validate::ItemSearch::de::AudienceRating, Net::Amazon::Validate::ItemSearch::de::Availability, Net::Amazon::Validate::ItemSearch::de::MaximumPrice, Net::Amazon::Validate::ItemSearch::de::BrowseNode, Net::Amazon::Validate::ItemSearch::de::Power, Net::Amazon::Validate::ItemSearch::de::Conductor, Net::Amazon::Validate::ItemSearch::de::Composer, Net::Amazon::Validate::ItemSearch::de::DeliveryMethod, Net::Amazon::Validate::ItemSearch::de::Magazines, Net::Amazon::Validate::ItemSearch::de::Performer, Net::Amazon::Validate::ItemSearch::de::Count, Net::Amazon::Validate::ItemSearch::de::Publisher, Net::Amazon::Validate::ItemSearch::de::State, Net::Amazon::Validate::ItemSearch::de::MusicLabel, Net::Amazon::Validate::ItemSearch::de::Brand, Net::Amazon::Validate::ItemSearch::de::MinimumPrice, Net::Amazon::Validate::ItemSearch::de::ItemPage, Net::Amazon::Validate::ItemSearch::de::Title, Net::Amazon::Validate::ItemSearch::de::Condition, Net::Amazon::Validate::ItemSearch::de::MerchantId, Net::Amazon::Validate::ItemSearch::de::Artist, Net::Amazon::Validate::ItemSearch::de::MPAARating, Net::Amazon::Validate::ItemSearch::de::Actor, Net::Amazon::Validate::ItemSearch::de::Author, Net::Amazon::Validate::ItemSearch::de::Orchestra, Net::Amazon::Validate::ItemSearch::de::TextStream, Net::Amazon::Validate::ItemSearch::de::Format, Net::Amazon::Validate::ItemSearch::fr::Sort, Net::Amazon::Validate::ItemSearch::fr::Manufacturer, Net::Amazon::Validate::ItemSearch::fr::ISPUPostalCode, Net::Amazon::Validate::ItemSearch::fr::EAN, Net::Amazon::Validate::ItemSearch::fr::Keywords, Net::Amazon::Validate::ItemSearch::fr::Director, Net::Amazon::Validate::ItemSearch::fr::PostalCode, Net::Amazon::Validate::ItemSearch::fr::AudienceRating, Net::Amazon::Validate::ItemSearch::fr::Availability, Net::Amazon::Validate::ItemSearch::fr::MaximumPrice, Net::Amazon::Validate::ItemSearch::fr::BrowseNode, Net::Amazon::Validate::ItemSearch::fr::Power, Net::Amazon::Validate::ItemSearch::fr::Conductor, Net::Amazon::Validate::ItemSearch::fr::Composer, Net::Amazon::Validate::ItemSearch::fr::DeliveryMethod, Net::Amazon::Validate::ItemSearch::fr::Magazines, Net::Amazon::Validate::ItemSearch::fr::Performer, Net::Amazon::Validate::ItemSearch::fr::Count, Net::Amazon::Validate::ItemSearch::fr::Publisher, Net::Amazon::Validate::ItemSearch::fr::State, Net::Amazon::Validate::ItemSearch::fr::MusicLabel, Net::Amazon::Validate::ItemSearch::fr::Brand, Net::Amazon::Validate::ItemSearch::fr::MinimumPrice, Net::Amazon::Validate::ItemSearch::fr::ItemPage, Net::Amazon::Validate::ItemSearch::fr::Title, Net::Amazon::Validate::ItemSearch::fr::Condition, Net::Amazon::Validate::ItemSearch::fr::MerchantId, Net::Amazon::Validate::ItemSearch::fr::Artist, Net::Amazon::Validate::ItemSearch::fr::Actor, Net::Amazon::Validate::ItemSearch::fr::Author, Net::Amazon::Validate::ItemSearch::fr::Orchestra, Net::Amazon::Validate::ItemSearch::fr::Format, Net::Amazon::Validate::ItemSearch::uk::Sort, Net::Amazon::Validate::ItemSearch::uk::Manufacturer, Net::Amazon::Validate::ItemSearch::uk::ISPUPostalCode, Net::Amazon::Validate::ItemSearch::uk::EAN, Net::Amazon::Validate::ItemSearch::uk::Keywords, Net::Amazon::Validate::ItemSearch::uk::Director, Net::Amazon::Validate::ItemSearch::uk::PostalCode, Net::Amazon::Validate::ItemSearch::uk::AudienceRating, Net::Amazon::Validate::ItemSearch::uk::Availability, Net::Amazon::Validate::ItemSearch::uk::MaximumPrice, Net::Amazon::Validate::ItemSearch::uk::BrowseNode, Net::Amazon::Validate::ItemSearch::uk::Power, Net::Amazon::Validate::ItemSearch::uk::Conductor, Net::Amazon::Validate::ItemSearch::uk::Composer, Net::Amazon::Validate::ItemSearch::uk::DeliveryMethod, Net::Amazon::Validate::ItemSearch::uk::Magazines, Net::Amazon::Validate::ItemSearch::uk::Performer, Net::Amazon::Validate::ItemSearch::uk::Count, Net::Amazon::Validate::ItemSearch::uk::Publisher, Net::Amazon::Validate::ItemSearch::uk::State, Net::Amazon::Validate::ItemSearch::uk::MusicLabel, Net::Amazon::Validate::ItemSearch::uk::Brand, Net::Amazon::Validate::ItemSearch::uk::MinimumPrice, Net::Amazon::Validate::ItemSearch::uk::ItemPage, Net::Amazon::Validate::ItemSearch::uk::Title, Net::Amazon::Validate::ItemSearch::uk::Condition, Net::Amazon::Validate::ItemSearch::uk::MerchantId, Net::Amazon::Validate::ItemSearch::uk::Artist, Net::Amazon::Validate::ItemSearch::uk::Actor, Net::Amazon::Validate::ItemSearch::uk::Author, Net::Amazon::Validate::ItemSearch::uk::Orchestra, Net::Amazon::Validate::ItemSearch::uk::TextStream, Net::Amazon::Validate::ItemSearch::uk::Format, Net::Amazon::Request::Blended, Net::Amazon::Request::Sort, Net::Amazon::Request::Manufacturer, Net::Amazon::Request::Seller, Net::Amazon::Request::EAN, Net::Amazon::Request::Director, Net::Amazon::Request::ISBN, Net::Amazon::Request::BrowseNode, Net::Amazon::Request::Power, Net::Amazon::Request::Wishlist, Net::Amazon::Request::Exchange, Net::Amazon::Request::Publisher, Net::Amazon::Request::MusicLabel, Net::Amazon::Request::Keyword, Net::Amazon::Request::ASIN, Net::Amazon::Request::Title, Net::Amazon::Request::UPC, Net::Amazon::Request::Artist, Net::Amazon::Request::Similar, Net::Amazon::Request::Actor, Net::Amazon::Request::Author, Net::Amazon::Request::TextStream, Net::Amazon::Result::Seller, Net::Amazon::Result::Seller::Listing

Source Code: Net::Amazon::Request


AUTHOR

Mike Schilli, <m@perlmeister.com>


COPYRIGHT AND LICENSE

Copyright 2003 by Mike Schilli <m@perlmeister.com>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.