Class AmazonOfferV2

Offer representing one offer for sale on Amazon (US, CA, DE, FR, or UK). The offer will be one of the 20 lowest priced offers for that condition, with the conditions being 'new', 'used' and 'collectible'

Class Summary

Using an AmazonOffer

var amz = FILLZ.SOURCE.AMAZONUS.v2;
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"
  debug('seller_id is ' + lowest_offer.seller_id); // outputs "seller_id is EXAMPLEID"
}

Properties

  • 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_buybox

    True if this offer appears in a Buy Box. There can be up to two Buy Box winners at any time per ASIN, one that is eligible for Prime and one that is not eligible for Prime. In addition, there are up to two Buy Boxes, one for used and one for new, each of which can have up to two winners at any given time, for a maximum of four across conditions and Prime eligible.

  • is_domestic

    True if the offer ships from a domestic location. In other words, if it is an amazon.com offer it ships from the USA, if an amazon.ca offer it ships from Canada, if an amazon.de offer it ships from Germany, if an amazon.fr offer it ships from France, or if an amazon.co.uk offer it ships from the United Kingdom.

  • is_expeditied

    True if expedited shipping is available for the offer.

  • is_fba

    True if the offer ships from an Amazon warehouse under the Fulfillment By Amazon (FBA) program.

  • is_featured

    True if the seller of the item is eligible to win the Buy Box.

  • is_international

    True if the item ships from an international location, the opposite of is_domestic.

  • is_amazon

    True if the item is shipped and sold by Amazon.

  • price

    Price of the offer, 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 offer 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 offer 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.

  • seller_id

    The seller identifier of the offer

  • condition

    Condition code of the offer, 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 of the offer. If the seller is brand new, the feedback will be returned as just_launched.

  • rating

    The percentage of positive feedback in the past 365 days for the seller of the offer. If the seller does not have any feedback during the past 365 days, or the seller is just launched, the rating will be 0. This returns the Number type.

  • is_just_launched

    True if the seller of the offer has just opened their seller account.

  • state

    The state that the offer is being shipped from.

  • country_code

    The 2 character ISO code representing the country that the offer ships from.