Determining Price, Merchant, Condition and Delivery Information

Items for sale on Amazon has offer listing(s). An offer listing for an item can be returned by using Offers resources and contains important offer related attributes.

This section is about how various offer related information is displayed on Amazon Retail Website and how to retrieve them from Product Advertising API (PA-API).

The following is an image of a Product Landing Page on Amazon.com (Important offer related attributes are highlighted in red boxes and numbered):

An example Product Landing Page on Amazon.com showcasing Offer attributes
Image 1.5.7.1-1 - An example Product Landing Page on Amazon.com showcasing Offer attributes

The following table is a legend for the offer attributes highlighted and numbered in the image above and how each of those attributes can be fetched from Product Advertising API through the Offers resources.

S.No. Description PA-API Offers Attribute
1 List Price: $27.00: This is the original list price of the product on which discount/savings are offered. It is also known as Strike-Through Price. If there is no discount/savings for an offer, then the strike-through price is not displayed. This offer attribute is referred as Saving Basis in Product Advertising API and can be fetched by requesting Offers.Listings.SavingBasis Offers resource. If there is no discount/savings available for an offer, then the SavingBasis information is not returned.
2 $14.59: This specifies the current buying price of the offer for the product for sale on Amazon. This offer attribute is referred as Price in Product Advertising API and can be fetched by requesting Offers.Listings.Price Offers resource. Irrespective of the fact that whether there is any discount/savings available for an offer, the current buying price will be returned under the Price container.
3 Save: $12.41 (46%): This specifies the amount and percentage savings for an offer. If there is no discount/savings for an offer, then the savings information is not displayed. This offer attribute is referred as Savings in Product Advertising API and is returned under Price container. It can be fetched by requesting Offers.Listings.Price Offers resource. It is calculated by taking Saving Basis as reference. If there is no discount/savings available for an offer, then the Savings information under Price container is not returned.
4 Prime Badge: This specifies if the offer is prime eligible. The prime badge is only displayed for prime eligible offers. This offer attribute is referred as IsPrimeEligible in Product Advertising API and is returned under Delivery Info container. It can be fetched by requesting Offers.Listings.DeliveryInfo.IsPrimeEligible Offers resource.
5 Free Shipping: This specifies if the offer is eligible for free shipping eligible. This offer attribute is referred as IsFreeShippingEligible in Product Advertising API and is returned under Delivery Info container. It can be fetched by requesting Offers.Listings.DeliveryInfo.IsFreeShippingEligible Offers resource.
6 Fulfilled by Amazon: This specifies if the offer is fulfilled by Amazon. This offer attribute is referred as IsAmazonFulfilled in Product Advertising API and is returned under Delivery Info container. It can be fetched by requesting Offers.Listings.DeliveryInfo.IsAmazonFulfilled Offers resource.
7 Sold by WhiteHill: This specifies the merchant or seller information for the offer which in this example is "WhiteHill". The offer attribute is referred as MerchantInfo in Product Advertising API and can be retrieved by requesting Offers.Listings.MerchantInfo Offers resource.
8 In Stock.: This specifies the availability message for the offer. It is used to infer whether the product is available in stock, is eligible for pre-order or back-order, etc. In this example, the offer is buyable and product is in stock. The offer attribute is referred as Availability Message in Product Advertising API and can be retrieved by requesting Offers.Listings.Availability.Message Offers resource.
8 Buy New: This specifies the condition of the item specified by the seller/merchant for the offer. It is used to infer whether the product being offered is New, Used, Refurbished, etc. Other than the case when the offer condition is New, a sub-condition information is displayed as well for e.g. Very Good, Good, Acceptable, etc. Refer Offers for more information. The offer attribute is referred as Condition and SubCondition in Product Advertising API and can be retrieved by requesting Offers.Listings.Condition, Offers.Listings.Condition.SubCondition Offers resources.

Product Advertising API Example

Following example request-response payload showcases how the all offer related information displayed on Amazon Product Landing Page for a sample ASIN as discussed above can be fetched from Product Advertising API:

Request Payload

{
  "ItemIds": ["1400064287"],
  "ItemIdType": "ASIN",
  "PartnerTag": "xyz-20",
  "PartnerType": "Associates",
  "Marketplace": "www.amazon.com",
  "Resources": [
    "Offers.Listings.Availability.Message",
    "Offers.Listings.Condition",
    "Offers.Listings.Condition.SubCondition",
    "Offers.Listings.DeliveryInfo.IsAmazonFulfilled",
    "Offers.Listings.DeliveryInfo.IsFreeShippingEligible",
    "Offers.Listings.DeliveryInfo.IsPrimeEligible",
    "Offers.Listings.MerchantInfo",
    "Offers.Listings.Price",
    "Offers.Listings.SavingBasis"
  ]
}

Response

{
 "ItemsResult": {
  "Items": [
   {
    "ASIN": "1400064287",
    "DetailPageURL": "https://www.amazon.com/dp/1400064287?tag=xyz-20&linkCode=ogi&th=1&psc=1",
    "Offers": {
     "Listings": [
      {
       "Availability": {
        "Message": "In Stock."
       },
       "Condition": {
        "SubCondition": {
         "Value": "New"
        },
        "Value": "New"
       },
       "DeliveryInfo": {
        "IsAmazonFulfilled": true,
        "IsFreeShippingEligible": true,
        "IsPrimeEligible": true
       },
       "Id": "7MO3lNG54smNn9nvMXRBzd4IENGa9Pf9EhgsKW8y6X",
       "MerchantInfo": {
        "DefaultShippingCountry": "US",
        "Id": "A110FNT8Q5QTXQ",
        "Name": "WhiteHill"
       },
       "Price": {
        "Amount": 14.59,
        "Currency": "USD",
        "DisplayAmount": "$14.59",
        "Savings": {
         "Amount": 12.41,
         "Currency": "USD",
         "DisplayAmount": "$12.41 (46%)",
         "Percentage": 46
        }
       },
       "SavingBasis": {
        "Amount": 27,
        "Currency": "USD",
        "DisplayAmount": "$27.00"
       },
       "ViolatesMAP": false
      }
     ]
    }
   }
  ]
 }
}

Price Per Unit

Sometimes, the product under Sale on Amazon contains multiple units For e.g. set of batteries, set of toilet papers, etc. In such scenarios, Amazon displays price per unit along with total price of the product on the Product Landing Page as follows:

An example Product Landing Page on Amazon.com showcasing Price Per Unit Offer Information
Image 1.5.7.1-2 - An example Product Landing Page on Amazon.com showcasing Price Per Unit Offer Information

In line with Amazon Retail Website, Product Advertising API also returns Price Per Unit information (if applicable) for all Offers resources which return price. Refer the following example:

Request Payload

{
  "ItemIds": ["B01KBEOQJU"],
  "ItemIdType": "ASIN",
  "PartnerTag": "xyz-20",
  "PartnerType": "Associates",
  "Marketplace": "www.amazon.com",
  "Resources": [
    "Offers.Listings.Price"
  ]
}

Response

{
 "ItemsResult": {
  "Items": [
   {
    "ASIN": "B01KBEOQJU",
    "DetailPageURL": "https://www.amazon.com/dp/B01KBEOQJU?tag=xyz-20&linkCode=ogi&th=1&psc=1",
    "Offers": {
     "Listings": [
      {
       "Id": "7MO3lNG54smNn9nvMXRBzd4IENGa9Pf9EhgsKW8y6X",
       "Price": {
        "Amount": 11.49,
        "Currency": "USD",
        "DisplayAmount": "$11.49 ($1.92 / Count)",
        "PricePerUnit": 1.92
       },
       "ViolatesMAP": false
      }
     ]
    }
   }
  ]
 }
}

results matching ""

    No results matching ""