Prime Exclusive Deal Pricing

Product Advertising API (PA-API) now supports Prime Exclusive Deal listings. 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 a listing in the OffersV2.Listings resource. In order to identify if a listing is a prime deal, use the OffersV2.Listings.DealDetails subfield of OffersV2. If "AccessType": "PRIME_EXCLUSIVE", then this listing represents a Prime Exclusive Deal.

Please note that if the OffersV2.Listings.DealDetails subfield is not present, this indicates that the listing is not a deal.

This listing operates in the same way as any other OffersV2 listing, including all supported OffersV2 fields.

See OffersV2 documentation for full details on possible values.

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

First, identify a product that currently has an active Prime Exclusive Deal.

Request

{
  "ItemIds": [
    "B01A6LUD4A"
  ],
  "Resources": [
    "OffersV2.Listings.Availability",
    "OffersV2.Listings.Condition",
    "OffersV2.Listings.DealDetails",
    "OffersV2.Listings.IsBuyBoxWinner",
    "OffersV2.Listings.LoyaltyPoints",
    "OffersV2.Listings.MerchantInfo",
    "OffersV2.Listings.Price",
    "OffersV2.Listings.Type"
  ],
  "PartnerTag": "PARTNERTAG",
  "PartnerType": "Associates",
  "Marketplace": "www.amazon.co.uk",
  "Operation": "GetItems"
}

Response

Note that there are 2 listings, the first is a prime exclusive deal, the second is available for all customers.

{
  "Items": [
    {
      "ASIN": "B01A6LUD4A",
      "DetailPageURL": "https://www.amazon.co.uk/dp/B01A6LUD4A?tag=PARTNERTAG&linkCode=ogi&th=1&psc=1",
      "OffersV2": {
        "__type": "com.amazon.paapi5.v2#OffersV2",
        "Listings": [
          {
            "Availability": {
              "Message": "In stock",
              "Type": "IN_STOCK"
            },
            "Condition": {
              "ConditionNote": "",
              "SubCondition": "Unknown",
              "Value": "New"
            },
            "DealDetails": {
              "AccessType": "PRIME_EXCLUSIVE",
              "Badge": "With Prime",
              "EndTime": "2025-05-25T22:59:59Z",
              "StartTime": "2025-04-29T23:00Z"
            },
            "IsBuyBoxWinner": true,
            "MerchantInfo": {
              "Id": "A3P5ROKL5A1OLE",
              "Name": "Amazon"
            },
            "Price": {
              "Money": {
                "Amount": 30.87,
                "Currency": "GBP",
                "DisplayAmount": "£30.87"
              },
              "SavingBasis": {
                "Money": {
                  "Amount": 54.99,
                  "Currency": "GBP",
                  "DisplayAmount": "£54.99"
                },
                "SavingBasisType": "LIST_PRICE",
                "SavingBasisTypeLabel": "RRP:"
              },
              "Savings": {
                "Money": {
                  "Amount": 24.12,
                  "Currency": "GBP",
                  "DisplayAmount": "£24.12"
                },
                "Percentage": 44
              }
            },
            "ViolatesMAP": false
          },
          {
            "Availability": {
              "MaxOrderQuantity": 3,
              "Message": "In stock",
              "MinOrderQuantity": 1,
              "Type": "IN_STOCK"
            },
            "Condition": {
              "ConditionNote": "",
              "SubCondition": "Unknown",
              "Value": "New"
            },
            "IsBuyBoxWinner": false,
            "MerchantInfo": {
              "Id": "A3P5ROKL5A1OLE",
              "Name": "Amazon"
            },
            "Price": {
              "Money": {
                "Amount": 32.5,
                "Currency": "GBP",
                "DisplayAmount": "£32.50"
              },
              "SavingBasis": {
                "Money": {
                  "Amount": 54.99,
                  "Currency": "GBP",
                  "DisplayAmount": "£54.99"
                },
                "SavingBasisType": "LIST_PRICE",
                "SavingBasisTypeLabel": "RRP:"
              },
              "Savings": {
                "Money": {
                  "Amount": 22.49,
                  "Currency": "GBP",
                  "DisplayAmount": "£22.49"
                },
                "Percentage": 41
              }
            },
            "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 featured as a listing returned in the OffersV2.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 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 shows all results returned from OffersV2.Listings resources.

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

Please note that if the OffersV2.Listings.DealDetails subfield is not present, this indicates that the listing is not a deal.

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

look for the listing with OffersV2.Listings.DealDetails AccessType = PRIME_EXCLUSIVE

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.

I just want offers that are available for all customers. I do not want to use the prime listing. What should I filter for?

filter for a listing where:

• OffersV2.Listings.DealDetails AccessType = ALL

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

Please note that if the OffersV2.Listings.DealDetails subfield is not present, this indicates that the listing is not a deal.

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:

• OffersV2.Listings.DealDetails AccessType = PRIME_EXCLUSIVE
• 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:

• OffersV2.Listings.DealDetails AccessType = PRIME_EXCLUSIVE

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

Outside of special event periods, there may not be many Prime Exclusive Deals available.

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.