NAME

Net::Amazon::Request::BrowseNode - request class for browse node search

SYNOPSIS

  use Net::Amazon;
  use Net::Amazon::Request::BrowseNode;

  my $ua = Net::Amazon->new(
      token       => 'YOUR_AMZN_TOKEN'
  );

  my $req = Net::Amazon::Request::BrowseNode->new( 
      browsenode  => 30,
      mode        => 'books'
  );

  # Response is of type Net::Amazon::Response::BrowseNode
  my $resp = $ua->request($req);

DESCRIPTION

"Net::Amazon::Request::BrowseNode" is a class used to submit node search requests to the Amazon web service.

The node to search for is specified in the "browsenode" parameter. The browse node ID is a number that corresponds to a general subject area of Amazon.com.

To find browse node IDs, the best way is to visit the "browse" area of the various product lines at Amazon.com. When you find a subject area that you would like to generate XML for, look at the web page URL. The browse ID should appear after the string "/tg/browse/-/". Here are some examples of URLs that contain browse IDs:

http://www.amazon.com/exec/obidos/tg/browse/-/30 (In this example, the browse ID = 30)
http://www.amazon.com/exec/obidos/tg/browse/-/467970 (In this example, the browse ID = 467970)
http://www.amazon.com/exec/obidos/tg/browse/-/602314 (In this example, the browse ID = 60231

Please be aware that some nodes cannot be used with a BrowseNodeSearch. (The vast majority of them can, but you may run across a few that simply will not work). It is also important to point out that from time to time, some browse nodes are deprecated or are changed without notice.

The catalog to search in is specified in the "mode" parameter, typical values are "books", "music", "classical" or "electronics".

An optional "keywords" parameter may be added to filter the results by that keyword.

Upon success, the responses' "properties()" method will return a list of "Net::Amazon::Properties::*" objects.

METHODS

new( browsenode => $nodeID, mode => $mode [, keywords => $keywords] ): Constructs a new "Net::Amazon::Request::BrowseNode" object, used to query the Amazon web service for items in a particular category (node) in the mode (catalog) specified.

Check Net::Amazon::Request for common request parameters not listed here.

AUTHOR

Net::Amazon framework by Mike Schilli, <m@perlmeister.com>

BrowseNode.pm by Jackie Hamilton, <kira@cgi101.com>

LICENSE

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