Class AmazonOffer

Offer groups representing one or more similar offers for sale on Amazon (US, CA, DE, FR, or UK). Grouping is done by condition, is_fba, is_domestic, handling_time, rating, and just_launched, and may only appear if within the cheapest 20 offers.

Class Summary

Using an AmazonOffer

var amz = FILLZ.SOURCE.AMAZONUS.v1;
var lowest_offer = amz.offers().lowest_price_offer();
if (lowest_offer) {
  debug('price is ' + lowest_offer.price); // outputs "price is 14.99"
  debug('shipping is ' + lowest_offer.shipping); // outputs "shipping is 2.98"
  debug('condition is ' + lowest_offer.condition); // outputs "condition is 11"
  debug('is_fba is ' + lowest_offer.is_fba); // outputs "is_fba is false"
}

Properties

  • count

    Number of offers in this group.

  • handling_time_min

    Minimum number of days expected for handling, not including shipping transit time.

  • handling_time_max

    Maximum number of days expected for handling, not including shipping transit time. Returns undefined value if unbounded.

  • is_domestic

    True if the offers in this group ship from a domestic location. In other words, if amazon.com orders ship from the USA, amazon.ca orders ship from Canada, amazon.de orders ship from Germany, amazon.fr orders ship from France, or amazon.co.uk orders ship from the United Kingdom.

  • is_fba

    True if the offers in this group ship from an Amazon warehouse under the Fulfillment By Amazon (FBA) program.

  • price

    Price of the cheapest offer in the group, excluding shipping. Currency is either USD, CAD, EUR, or GBP, depending on source. Returns a Number with up to 2 decimal places of precision.

  • shipping

    Shipping amount of the cheapest offer in the group for a domestic buyer. Currency is either USD, CAD, EUR, or GBP, depending on source. Returns a Number with up to 2 decimal places of precision.

  • total

    Total landed price (price + shipping) of the cheapest offer in the group for a domestic buyer. Currency is either USD, CAD, EUR, or GBP, depending on source. This value is equivalent to the sum of the price and shipping properties. Returns a Number with up to 2 decimal places of precision.

  • condition

    Condition code of all offers in this group, an integer as follows: * 11 (New) * 1 (Used; Like New), 2 (Used; Very Good), 3 (Used; Good), 4 (Used; Acceptable) * 5 (Collectible; Like New), 6 (Collectible; Very Good), 7 (Collectible; Good), 8 (Collectible; Acceptable)

  • feedback

    The number of seller feedback ratings that have been submitted for the seller with the cheapest offer listing in the group.

  • rating_min

    Minimum percentage of positive ratings for sellers in this group.

  • rating_max

    Maximum percentage of positive ratings for sellers in this group.

  • is_just_launched

    True if the offers in this group are for sellers who have just opened their seller account.

  • has_many_at_price

    True if there is more than one offer in this group at the cheapest price.