Determining Offer Summaries

The Product Landing Page of any item on Amazon Retail Website displays the BuyBox winner offer (if available) and summaries of offer listings across various product conditions. Summary of all available offer listings is returned through Product Advertising API as Offer Summaries by requesting Offers resources specific to Offer Summaries.

The following images below show how offer summary information is displayed on Amazon Retail Website:

Offer Summary information of a product can be retrieved by requesting Offer Summaries Resources. An example on how to get Offer Summaries information from Product Advertising API is as follows:

Note: The example below depicts information displayed in Image-2 above:

Request Payload

{
  "ItemIds": ["B07MVPTK1D"],
  "ItemIdType": "ASIN",
  "PartnerTag": "xyz-20",
  "PartnerType": "Associates",
  "Marketplace": "www.amazon.com",
  "Resources": [
    "Offers.Summaries.HighestPrice",
    "Offers.Summaries.LowestPrice",
    "Offers.Summaries.OfferCount"
  ]
}

Response

{
 "ItemsResult": {
  "Items": [
   {
    "ASIN": "B07MVPTK1D",
    "DetailPageURL": "https://www.amazon.com/dp/B07MVPTK1D?tag=xyz-20&linkCode=ogi&th=1&psc=1",
    "Offers": {
     "Summaries": [
      {
       "Condition": {
        "Value": "New"
       },
       "HighestPrice": {
        "Amount": 501.76,
        "Currency": "USD",
        "DisplayAmount": "$501.76"
       },
       "LowestPrice": {
        "Amount": 485.5,
        "Currency": "USD",
        "DisplayAmount": "$485.50"
       },
       "OfferCount": 5
      },
      {
       "Condition": {
        "Value": "Used"
       },
       "HighestPrice": {
        "Amount": 479.99,
        "Currency": "USD",
        "DisplayAmount": "$479.99"
       },
       "LowestPrice": {
        "Amount": 479.9,
        "Currency": "USD",
        "DisplayAmount": "$479.90"
       },
       "OfferCount": 2
      }
     ]
    }
   }
  ]
 }
}

Few notes on the example above:

• When any of the Offer Summaries resource is requested, Product Advertising API returns all offer summaries for the product across item conditions.
• As shown in the example above, there are 7 offers across Used and New product conditions. This information is represented in the OfferCount attribute of the Offer Summary. This information is inline with the Image-2 which shows there are "7 New and Used Offers".
• The HighestPrice and LowestPrice attributes for an Offer Summary represents the highest and lowest price of all offers for a particular condition. For e.g. The LowestPrice of all "New" Offers is $485.50 and that of all "Used" offers is $479.90.