Prime Exclusive Deal Pricing

Product Advertising API (PA-API) is beginning roll out support for Prime Exclusive pricing information. This will enable you to fetch real-time Prime pricing information for events such as Prime Day as well as Prime deals throughout the year.

What are the technical details? How will I need to update the existing API response?

We are surfacing this information through an additional listing in the Offers.Listings resource. For some products, you may begin seeing an additional listing returned in the API response, which is for the Prime price, in addition to the existing BuyBox winner listing. We will be using the existing ProgramEligibility.IsPrimeExclusive flag to identify this new additional listing, so that you can identify whether the listing is a price only available to Prime members (true means that this is a prime exclusive listing). Most listings will have a value of false for this flag.

The isPrimeExclusive flag was previously used to indicate products that only Prime members can buy, but there are very few such products. As such, we will be changing the definition of isPrimeExclusive for this new feature as described.

As we iteratively roll out this feature, additional information other than the price may be limited on this new listing. For the new listing, we will begin by surfacing only:

• price (Offers.Listings.Price)
• savings (Offers.Listings.SavingBasis)
• BuyBox winner (Offers.Listings.IsBuyboxWinner)
• Prime Exclusive indicator flag (Offers.Listings.ProgramEligibility.IsPrimeExclusive)
• the ViolatesMAP field

The other fields in the Offers.Listings object will not be available until a later date.

If you do not wish to consume this feature, ensure that your code filters out offer listings that have the IsPrimeExclusive field set to true.

See example requests below for more details.

How do I find examples of Prime Exclusive deals on the Amazon Website?

Visit the Amazon Deals Page, and use the Prime Exclusive filter on the bottom left

Example

Request

{
  "ItemIds": [
    "B0BHZT5S12"
  ],
  "Resources": [
    "Offers.Listings.IsBuyBoxWinner",
    "Offers.Listings.Price",
    "Offers.Listings.ProgramEligibility.IsPrimeExclusive",
    "Offers.Listings.SavingBasis"
  ],
  "PartnerTag": "baba",
  "PartnerType": "Associates",
  "Marketplace": "www.amazon.com",
  "Operation": "GetItems"
}

Response

Note that there are 2 listings, one which is available for all customers, and one which is prime exclusive

{
 "ItemsResult": {
  "Items": [
   {
    "ASIN": "B0BHZT5S12",
    "DetailPageURL": "https://www.amazon.com/dp/B0BHZT5S12?tag=baba&linkCode=ogi&th=1&psc=1",
    "Offers": {
     "Listings": [
      {
       "Id": "Bs%2BmjFjUF1pJ3XAiff4g8YqknG%2Fbg1cSqnItUCV7wf0IfZzt%2BEFA2DxBQ3fwVFinUv89wcYyYY3GMD70XTgmQdcRw2IxR0IoulINgTDKqzd%2FUJpDIxOfcnkLfdIjVMRjuQhfPyZ6EG%2FPSWxKpAifzw%3D%3D",
       "IsBuyBoxWinner": true,
       "Price": {
        "Amount": 139.99,
        "Currency": "USD",
        "DisplayAmount": "$139.99"
       },
       "ProgramEligibility": {
        "IsPrimeExclusive": false
       },
       "ViolatesMAP": false
      },
      {
       "IsBuyBoxWinner": true,
       "Price": {
        "Amount": 74.99,
        "Currency": "USD",
        "DisplayAmount": "$74.99",
        "PriceTypeLabel": "With Deal:",
        "Savings": {
         "Amount": 65,
         "Currency": "USD",
         "DisplayAmount": "$65.00 (46%)",
         "Percentage": 46
        }
       },
       "ProgramEligibility": {
        "IsPrimeExclusive": true
       },
       "SavingBasis": {
        "Amount": 139.99,
        "Currency": "USD",
        "DisplayAmount": "$139.99",
        "PriceType": "LIST_PRICE",
        "PriceTypeLabel": "List Price:"
       },
       "ViolatesMAP": false
      }
     ]
    }
   }
  ]
 }
}

FAQ

What is the Prime Exclusive price?

The Prime Exclusive price is the price an Amazon Prime member would pay for the product, which can be a different price from what a non-Prime member would pay. These deals are especially important during Prime Day and other big events.

How do I consume the new prime price information?

It will be added as an additional listing returned in the Offers.Listings sub-resource if there is a Prime deal available. You may continue calling this resource as before in PA-API, and then perform additional logic to filter for either the Prime price listing, or the existing all customer price listings.

What kind of Prime offers will be covered by this feature?

This feature will cover event based Prime Exclusive Deals, such as those featured on the Amazon Deals Page when using the Prime Exclusive filter.

What if I am not interested in this feature currently?

You may continue consuming the Offers API as before, but you will need to filter out the new Prime pricing listing if your logic currently shows all results returned from Offers.Listings resources.

Do not make any assumptions about the order of the response, use the IsPrimeExclusive and isBuyboxWinner field values to confirm.

There are multiple listings being returned now. How do I know which listing is the Prime price?

look for the listing with IsPrimeExclusive = true

There are multiple listings being returned now. How do I know which listing is the BuyBox winner?

check the isBuyboxWinner field to confirm that the listing is the one associated with being the BuyBox winner.

Do not make any assumptions about the order of the response, use the field values to confirm.

Can there be more than one BuyBox winner listing now?

Yes, it is possible that there will be 2:

• 1 BuyBox winner listing with IsPrimeExclusive = true
• 1 BuyBox winner listing with IsPrimeExclusive = false

You will need to filter as appropriate. Do not make any assumptions about the order of the response, use the field values to confirm

I just want to get the old buy box winner listing that is for all customers. I do not want to use the new prime listing. What should I filter for?

filter for a listing where:

• IsPrimeExclusive = false
• isBuyBoxWinner = true

Do not make any assumptions about the order of the response, use the field values to confirm

I want to know if a listing is both the prime price and the buy box winner. What should I filter for?

filter for a listing where:

• IsPrimeExclusive = true

• isBuyBoxWinner = true

Do not make any assumptions about the order of the response, use the field values to confirm

Is it possible that the prime price listing is not the buy box winner?

Yes, this is possible.

This will be indicated by a listing where:

• IsPrimeExclusive = true

• isBuyBoxWinner = false

Do not make any assumptions about the order of the response, use the field values to confirm

Why can I not find any Prime Exclusive Deals?

Not all marketplaces support Prime Exclusive deals, in which case you will not see the filter, and not be able to find any such offers.

As Amazon continues to evolve its prime benefits, PA-API will also continue to expand coverage. You may see fluctuation in the volume of Prime Exclusive deals available.

Why do I see a discrepancy in the returned OfferCount value and the number of offers?

When Prime pricing is available for a product, there will be two (or more) listings instead of the existing one in the Offers object. You may see a mismatch in the returned offerCount field vs the number of offerings in the list.