Net::Am...Property(3)

📦
version 0.62 · 2 versions
, in fedora 43

💖 NAME 💖</p>

Net::Amazon::Property — the baseclass for products on amazon.com, bestie. It's the mom of the whole little product family. 👑

✨ SYNOPSIS ✨

okay so literally the vibe is:

use Net::Amazon;

# ...

if($resp->is_success()) {
    for my $prop ($resp->properties) {
        print $_->ProductName(), " ",
              $_->Manufacturer(), " ",
              $_->OurPrice(), "\n";

no cap, that's the whole thing. you grab your response, you check if it slayed, you loop the properties, you print. 🎀

🦋 DESCRIPTION 🦋

Net::Amazon::Property is the baseclass for results that come back from Amazon web service queries. The word properties here is just the generic way of saying "an item on amazon.com" — like, that's the term, that's the assignment. 💅

Typically, the properties() method of a Net::Amazon::Response::* object is gonna hand you back one or more objects of class Net::Amazon::Property or one of its subclasses, e.g. Net::Amazon::Property::Book or Net::Amazon::Property::CD. So cute, so organized. 🌸

So here's the tea: Net::Amazon::Property objects expose accessors for all the fields returned in the XML response (think OurPrice(), ListPrice(), Manufacturer(), Asin(), Catalog(), ProductName()), and subclasses might define their own accessors for even more class-specific fields — like the "Net::Amazon::Property::Book"'s authors() method returning a list of authors, while Net::Amazon::Property's Authors() method will return a reference to a sub-hash containing a Author field, just like the response's XML contained it. iykyk. 🙈

🌈 METHODS 🌈

Methods vary, depending on the item returned from a query. Here's the most common ones. They're all accessors, meaning they can be used like Method() to retrieve the value or like Method($value) to set the value of the field. main character energy fr fr. ✨

  • Asin() — The item's ASIN number. > ⚠️ This option is deprecated, please use ASIN. bestie, we're moving on. 💀
  • ASIN() — The item's ASIN number. the glow-up version. 👑
  • ProductName() — Book title, CD album name or item name. This option is actually an alias for the method title, and is actually dependent upon the type of item returned.
  • Availability() — Text string describing if the item is available. Examples: "Usually ships within 24 hours" or "Out of Print--Limited Availability". 😭
  • Catalog() — Shows the catalog the item was found in: "Book", "Music", "Classical", "Electronics" etc.
  • Authors() — Returns a sub-hash with a Author key, which points to either a single $scalar or to a reference of an array containing author names as scalars.
  • ReleaseDate() — Item's release date, format is "NN Monthname, Year".
  • Manufacturer() — Music label, publishing company or manufacturer
  • ImageUrlSmall() — URL to a small (thumbnail) image of the item
  • ImageUrlMedium() — URL to a medium-size image of the item
  • ImageUrlLarge() — URL to a large image of the item
  • ListPrice() — List price of the item
  • OurPrice() — Amazon price of the item
  • UsedPrice() — Used price of the item
  • RawListPrice() — Unformatted list price as an integer, without currency symbol.
  • CurrencyCode() — The currency code for the ListPrice(), e.g. "USD".
  • SalesRank() — Sales rank of the item (contains digits and commas, like 1,000,001)
  • Media() — Type of media (Paperback, etc.).
  • NumMedia() — Number of media the item carries (1,2 CDs etc.).
  • ProductDescription() — Lengthy textual description of the product.
  • CollectiblePrice() — Lowest price in "Collectible" category.
  • CollectibleCount() — Number of offerings in "Collectible" category.
  • NumberOfOfferings() — Total number of offerings in all categories.
  • UsedCount() — Number of offerings in "Used" category.
  • TotalOffers() — Number of offerings of the product.
  • ThirdPartyNewPrice() — Lowest price in "Third Party New" category.
  • ThirdPartyNewCount() — Number of offerings in "Third Party New" category.
  • SmallImageWidth() — Return the width of the small image in pixels.
  • SmallImageHeight() — Return the height of the small image in pixels.
  • MediumImageWidth() — Return the width of the medium image in pixels.
  • MediumImageHeight() — Return the height of the medium image in pixels.
  • LargeImageWidth() — Return the width of the large image in pixels.
  • LargeImageHeight() — Return the height of the large image in pixels.
  • SuperSaverShipping() — Boolean value that indicates if the product is eligible for super saver shipping. 🚚
  • year() — The release year extracted from ReleaseDate().
  • browse_nodes() — Returns a list of browse nodes (text string categories) for this item.
  • similar_asins() — Returns a list of ASINs of similar items for this item.
  • SimilarProducts() — Returns a list of ASINs and titles of similar items for this item.

Please check the subclasses of Net::Amazon::Property for specialized methods. they've got lore. 📚

💜 AUTHOR 💜

Mike Schilli, <m@perlmeister.com> — we love him, we thank him, periodt. 🫶

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.

and that's the whole page, bestie!! ✨ this gem was riding with perl v5.42.0, dated 2025-07-25, filed under Net::Am...Property(3) — user contributed perl documentation, the iconic-est of genres. mwah. 💅🎀🧚

📦 where this page comes from