Offers
The Offers resource contains various resources related to offer listings and summaries for an item.
The response can be controlled though various optional parameters such as Condition and MerchantId. By default, the BuyBox winner offer is returned.
For more information on how to consume and best use the offer information returned via Product Advertising API, refer Using Offer Information .
Resources
Listings
Specifies about various offer listings associated with the product.
Attribute Name
Type
Description
Availability
Struct
Specifies availability information about an offer
Condition
Struct
Specifies the condition of the offer.
DeliveryInfo
Struct
Specifies delivery information of an offer
Id
String
An unique identifier for offer listing
IsBuyboxWinner
Boolean
Specifies whether the given offer is the winner of the BuyBox in the Detail Page (DP) of an item. This is the best offer recommended by Amazon for any product. This featured offer is seen on Detail Page on an ASIN.
LoyaltyPoints
Struct
Specifies loyalty points related information for an offer (Currently only supported in Japan marketplace)
MerchantInfo
Struct
Specifies seller information of an offer
Price
Struct
Specifies buying price of an offer
ProgramEligibility
Struct
Specifies about the involvement of various Amazon programs that an offer is associated with
Promotions
List of Struct
Specifies about different types of promotions like SNS (Subscribe & Save) from which a customer can get benefit from
SavingBasis
Struct
Refers to the strike-through price for a particular offer. This is used to determine the savings that Amazon offers to its customer
ViolateMAP
Boolean
Specifies whether an offer violates MAP policy or not. Please refer this for more details
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Availability" : {
...
} ,
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"DeliveryInfo" : {
...
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"IsBuyboxWinner" : true ,
"MerchantInfo" : {
...
} ,
"Price" : {
...
} ,
"ProgramEligibility" : {
...
} ,
"Promotions" : [
...
] ,
"SavingBasis" : {
...
} ,
"ViolatesMAP" : false
}
] ,
...
}
}
Copy
Summaries
Specifies the summary of all offer listings available for the product.
Note: The offer summary for each available Offer Condition Type is returned irrespective of value specified in the Condition
request parameter.
Attribute Name
Type
Description
Condition
Struct
Specifies the condition of the offer.
HighestPrice
Struct
Specifies highest buying price for a given item for a particular condition
LowestPrice
Struct
Specifies lowest buying price for a given item for a particular condition
OfferCount
Integer
Total number of offers for a given item for a particular condition
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Summaries" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"OfferCount" : 16 ,
"HighestPrice" : {
...
} ,
"LowestPrice" : {
...
}
}
] ,
...
}
}
Copy
Availability
Attribute Name
Type
Description
MaxOrderQuantity
Integer
Specifies the maximum quantity of a product that can be purchased
Message
String
Specifies availability message of product as seen on Detail page (DP) of an ASIN
MinOrderQuantity
Integer
Specifies minimum number of quantity needed to make purchase of a product
Type
String
Describe about the availability type of product.Valid Values : Now, Backorderable and Preorderable
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Availability" : {
"MinOrderQuantity" : 1 ,
"MaxOrderQuantity" : 36 ,
"Message" : "In Stock." ,
"Type" : "Now"
} ,
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"ViolatesMAP" : false ,
...
}
]
}
}
Copy
Condition
Attribute Name
Type
Description
ConditionNote
Struct
Specifies the product condition as provided by the seller
DisplayValue
String
Specifies the condition in the specified locale.
Label
String
The label condition
in the specified locale
Locale
String
The locale in which the condition is returned
Value
String
Specifies the offer condition. Valid Values : New, Used, Collectible and Refurbished
SubCondition
Struct
Specifies about subcondition of an offer
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Availability" : {
"MinOrderQuantity" : 1 ,
"MaxOrderQuantity" : 36 ,
"Message" : "In Stock." ,
"Type" : "Now"
} ,
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"ViolatesMAP" : false ,
...
}
]
}
}
Copy
ConditionNote
Attribute Name
Type
Description
Locale
String
The locale in which the condition note is returned.
Value
String
Specifies the offer condition note.
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Availability" : {
"MinOrderQuantity" : 1 ,
"MaxOrderQuantity" : 36 ,
"Message" : "In Stock." ,
"Type" : "Now"
} ,
"Condition" : {
"ConditionNote" : {
"Locale" : "en_US" ,
"Value" : "Mint condition"
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"ViolatesMAP" : false ,
...
}
]
}
}
Copy
DeliveryInfo
Attribute Name
Type
Description
IsAmazonFulfilled
Boolean
Specifies whether a product is fulfilled by Amazon
IsFreeShippingEligible
Boolean
Specifies whether a product is eligible for free shipping
IsPrimeEligible
Boolean
Specifies about the prime eligibility about the product
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"DeliveryInfo" : {
"IsAmazonFulfilled" : true ,
"IsFreeShippingEligible" : true ,
"IsPrimeEligible" : true
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"ViolatesMAP" : false ,
...
}
]
}
}
Copy
LoyaltyPoints
Attribute Name
Type
Description
Points
Integer
Specifies loyalty points associated with an offer
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"LoyaltyPoints" : {
"Points" : 3020
} ,
"ViolatesMAP" : false ,
...
]
}
}
Copy
MerchantInfo
Attribute Name
Type
Description
DefaultShippingCountry
String
The default shipping country (as an abbreviation) from where the merchant/seller ships
FeedbackCount
Integer
Seller feedback count for the past 12 months
FeedbackRating
Double
Seller feedback rating
Id
String
An unique identifier for merchant/seller
Name
String
The name of merchant/seller
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"MerchantInfo" : {
"DefaultShippingCountry" : "US" ,
"FeedbackCount" : 3670 ,
"FeedbackRating" : 4.5 ,
"Id" : "ATVPDKIKX0DER" ,
"Name" : "Amazon.com"
} ,
"ViolatesMAP" : false ,
...
]
}
}
Copy
Price
Attribute Name
Type
Description
Amount
Double
Specifies buying amount of an offer
Currency
String
Specifies the currency associate with the buying amount
DisplayAmount
String
Specifies formatted buying price of an offer as shown on Amazon page
PricePerUnit
Double
Specifies buying amount per unit of an offer
Savings
Struct
Specifies savings on an offer. This is calculated by taking reference as saving basis price
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"Price" : {
"Amount" : 46.99 ,
"Currency" : "USD" ,
"PricePerUnit" : 0.22 ,
"DisplayAmount" : "$46.99 ($0.22 / Count)" ,
"Savings" : {
...
}
} ,
"ViolatesMAP" : false ,
...
]
}
}
Copy
ProgramEligibility
Attribute Name
Type
Description
IsPrimeExclusive
Boolean
Specifies whether a product is associated with a prime exclusive price (only available to prime members). See Prime Exclusive Deal Pricing Guide for more info.
IsPrimePantry
Boolean
Specifies whether a product is associated with prime pantry program
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"ProgramEligibility" : {
"IsPrimeExclusive" : false ,
"IsPrimePantry" : false
} ,
"ViolatesMAP" : false ,
...
]
}
}
Copy
Attribute Name
Type
Description
Amount
Double
Specifies buying amount of an offer after applying promotion
Currency
String
Specifies the currency associate with the buying amount
DiscountPercent
String
Specifies discount percentage offered to a customer via promotion
DisplayAmount
String
Specifies formatted buying price of an offer after applying promotion as shown on Amazon page
PricePerUnit
Double
Specifies buying amount per unit of an offer after applying promotion
Type
String
Specifies the type of promotion from which a customer is getting benefitedValid Values : SNS
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"Promotions" : [
{
"Type" : "SNS" ,
"Amount" : 49.34 ,
"Currency" : "USD" ,
"DiscountPercent" : 5 ,
"PricePerUnit" : 0.23 ,
"DisplayAmount" : "$49.34 (5%)"
}
] ,
"ViolatesMAP" : false ,
...
]
}
}
Copy
SavingBasis
Attribute Name
Type
Description
Amount
Double
Specifies strike-through/reference amount of an offer
Currency
String
Specifies the currency associate with the buying amount
DisplayAmount
String
Specifies formatted strike-through/reference price of an offer as shown on Amazon page
PricePerUnit
Double
Specifies strike-through/reference amount per unit of an offer
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"SavingBasis" : {
"Amount" : 54.8 ,
"Currency" : "USD" ,
"PricePerUnit" : 0.25 ,
"DisplayAmount" : "$54.8 ($0.25 / Count)"
} ,
"ViolatesMAP" : false ,
...
}
]
}
}
Copy
HighestPrice
Attribute Name
Type
Description
Amount
Double
Specifies highest buying amount among all offers for a particular condition
Currency
String
Specifies the currency associate with the buying amount
DisplayAmount
String
Specifies formatted highest buying price among all offers for a particular condition as shown on Amazon page
PricePerUnit
Double
Specifies highest buying amount per unit among all offers for a particular condition
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Summaries" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New"
} ,
"HighestPrice" : {
"Amount" : 67.32 ,
"Currency" : "USD" ,
"PricePerUnit" : 0.31 ,
"DisplayAmount" : "$67.32 ($0.31 / Count)"
} ,
...
}
]
}
}
Copy
LowestPrice
Attribute Name
Type
Description
Amount
Double
Specifies lowest buying amount among all offers for a particular condition
Currency
String
Specifies the currency associate with the buying amount
DisplayAmount
String
Specifies formatted lowest buying price among all offers for a particular condition as shown on Amazon page
PricePerUnit
Double
Specifies lowest buying amount per unit among all offers for a particular condition
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Summaries" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New"
} ,
"LowestPrice" : {
"Amount" : 45.55 ,
"Currency" : "USD" ,
"PricePerUnit" : 0.21 ,
"DisplayAmount" : "$45.55 ($0.21 / Count)"
} ,
...
}
]
}
}
Copy
Savings
Attribute Name
Type
Description
Amount
Double
Specifies savings amount on an offer
Currency
String
Specifies the currency associate with the buying amount
DisplayAmount
String
Specifies formatted savings price on an offer as shown on Amazon page
Percentage
Integer
Specifies savings percentage on an offer
PricePerUnit
Double
Specifies savings amount per unit on an offer
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"IsBuyboxWinner" : true ,
"Price" : {
"Savings" : {
"Amount" : 7.81 ,
"Currency" : "USD" ,
"Percentage" : 14 ,
"PricePerUnit" : 0.04 ,
"DisplayAmount" : "$7.81 (14%)"
} ,
...
} ,
"ViolatesMAP" : false ,
...
}
]
}
}
Copy
SubCondition
Attribute Name
Type
Description
DisplayValue
String
Specifies the subcondition in the specified locale.
Label
String
The label subcondition
in the specified locale
Locale
String
The locale in which the subcondition is returned
Value
String
Specifies the offer subcondition. Valid Values : Acceptable, Club, Good, LikeNew, New, OEM, Other, OpenBox, Poor, Refurbished, RefurbishedWarranty, VeryGood, Warranty
Sample Response
{
"ASIN" : "B00DFFT9SQ" ,
"Offers" : {
"Listings" : [
{
"Availability" : {
"MinOrderQuantity" : 1 ,
"MaxOrderQuantity" : 36 ,
"Message" : "In Stock." ,
"Type" : "Now"
} ,
"Condition" : {
"SubCondition" : {
"DisplayValue" : "Bueno" ,
"Label" : "SubCondición" ,
"Locale" : "es_US" ,
"Value" : "Good"
}
} ,
"Id" : "%2BYr4ObZ6UUzbxAkNlqDMK0nqqShOsSBxASbCealFghrty39HGfLJ3A7RKKm%2Bp1KIgJp90w3Q8Z%2FxgR5ooR60m4eHDmwOM%2FjmuUwydbWC7A7udrnG9kRZ%2FQ%3D%3D" ,
"ViolatesMAP" : false ,
...
}
]
}
}
Copy
Relevant Operations
Operations that can use these resources include:
Sample Use Cases
Example 1
Get the price of Buy Box winner offer of an item
Request Payload
{
"ItemIds" : [
"B00KL8SM92"
] ,
"ItemIdType" : "ASIN" ,
"PartnerTag" : "xyz-20" ,
"PartnerType" : "Associates" ,
"Resources" : [
"Offers.Listings.Price"
]
}
Copy
Response
{
"ItemsResult" : {
"Items" : [
{
"ASIN" : "B00KL8SM92" ,
"DetailPageURL" : "https://www.amazon.com/dp/B00KL8SM92?tag=xyz-20&linkCode=ogi&th=1&psc=1" ,
"Offers" : {
"Listings" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"Id" : "Ld6nMKe3S72VnlTk6pxxbux6CoYlVOGlGGhK%2BNkowW%2BXXLjHHwK8PxORLCjPGaC1HxZVRcHe8QHC48iaeU7lxZ0xHoGx7K%2BX7pNnrf5F9OZhcJjnqNbHuQ%3D%3D" ,
"Price" : {
"Amount" : 29.99 ,
"Currency" : "USD" ,
"DisplayAmount" : "$29.99" ,
"Savings" : {
"Amount" : 5.3 ,
"Currency" : "USD" ,
"DisplayAmount" : "$5.30 (15%)" ,
"Percentage" : 15
}
} ,
"ViolatesMAP" : false
}
]
}
}
]
}
}
Copy
Example 2
Get all resources related to offer listings and summaries of an item for a particular condition
Request Payload
{
"Condition" : "New" ,
"ItemIds" : [
"B00KL8SM92"
] ,
"ItemIdType" : "ASIN" ,
"PartnerTag" : "xyz-20" ,
"PartnerType" : "Associates" ,
"Resources" : [
"Offers.Listings.Availability.MaxOrderQuantity" ,
"Offers.Listings.Availability.Message" ,
"Offers.Listings.Availability.MinOrderQuantity" ,
"Offers.Listings.Availability.Type" ,
"Offers.Listings.Condition" ,
"Offers.Listings.Condition.ConditionNote" ,
"Offers.Listings.Condition.SubCondition" ,
"Offers.Listings.DeliveryInfo.IsAmazonFulfilled" ,
"Offers.Listings.DeliveryInfo.IsFreeShippingEligible" ,
"Offers.Listings.DeliveryInfo.IsPrimeEligible" ,
"Offers.Listings.IsBuyBoxWinner" ,
"Offers.Listings.LoyaltyPoints.Points" ,
"Offers.Listings.MerchantInfo" ,
"Offers.Listings.Price" ,
"Offers.Listings.ProgramEligibility.IsPrimeExclusive" ,
"Offers.Listings.ProgramEligibility.IsPrimePantry" ,
"Offers.Listings.Promotions" ,
"Offers.Listings.SavingBasis" ,
"Offers.Summaries.HighestPrice" ,
"Offers.Summaries.LowestPrice" ,
"Offers.Summaries.OfferCount"
]
}
Copy
Response
{
"ItemsResult" : {
"Items" : [
{
"ASIN" : "B00KL8SM92" ,
"DetailPageURL" : "https://www.amazon.com/dp/B00KL8SM92?tag=xyz-20&linkCode=ogi&th=1&psc=1" ,
"Offers" : {
"Listings" : [
{
"Availability" : {
"Message" : "In Stock." ,
"MinOrderQuantity" : 1 ,
"Type" : "Now"
} ,
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"DeliveryInfo" : {
"IsAmazonFulfilled" : true ,
"IsFreeShippingEligible" : true ,
"IsPrimeEligible" : true
} ,
"Id" : "uXlVLdDbCfHTdwfSFF7G%2BXRQ%2BIf8pMbI9B29z2mv0j%2FlMKBGhOCuuRSa0ki%2BuUF9797EBbf%2F9BsG8swcjX6LubdAPmkHl%2Fuw6GxVI3nSInXfBzbdTRdTuQ%3D%3D" ,
"IsBuyBoxWinner" : true ,
"LoyaltyPoints" : {
"Points" : 3020
} ,
"MerchantInfo" : {
"DefaultShippingCountry" : "US" ,
"FeedbackCount" : 3670 ,
"FeedbackRating" : 4.5 ,
"Id" : "ATVPDKIKX0DER" ,
"Name" : "Amazon.com"
} ,
"Price" : {
"Amount" : 29.99 ,
"Currency" : "USD" ,
"DisplayAmount" : "$29.99" ,
"Savings" : {
"Amount" : 5.3 ,
"Currency" : "USD" ,
"DisplayAmount" : "$5.30 (15%)" ,
"Percentage" : 15
}
} ,
"ProgramEligibility" : {
"IsPrimeExclusive" : false ,
"IsPrimePantry" : false
} ,
"SavingBasis" : {
"Amount" : 35.29 ,
"Currency" : "USD" ,
"DisplayAmount" : "$35.29"
} ,
"ViolatesMAP" : false
}
] ,
"Summaries" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New"
} ,
"HighestPrice" : {
"Amount" : 293.26 ,
"Currency" : "USD" ,
"DisplayAmount" : "$293.26"
} ,
"LowestPrice" : {
"Amount" : 23 ,
"Currency" : "USD" ,
"DisplayAmount" : "$23.00"
} ,
"OfferCount" : 45
}
]
}
}
]
}
}
Copy
Example 3
Get all resources related to offer listings and summaries of an item for which any one of the offer violates MAP policy.
Request Payload
{
"ItemIds" : [
"B0153V644G"
] ,
"ItemIdType" : "ASIN" ,
"Marketplace" : "www.amazon.com" ,
"PartnerTag" : "xyz-20" ,
"PartnerType" : "Associates" ,
"Resources" : [
"Offers.Listings.Availability.MaxOrderQuantity" ,
"Offers.Listings.Availability.Message" ,
"Offers.Listings.Availability.MinOrderQuantity" ,
"Offers.Listings.Availability.Type" ,
"Offers.Listings.Condition" ,
"Offers.Listings.Condition.ConditionNote" ,
"Offers.Listings.Condition.SubCondition" ,
"Offers.Listings.DeliveryInfo.IsAmazonFulfilled" ,
"Offers.Listings.DeliveryInfo.IsFreeShippingEligible" ,
"Offers.Listings.DeliveryInfo.IsPrimeEligible" ,
"Offers.Listings.IsBuyBoxWinner" ,
"Offers.Listings.MerchantInfo" ,
"Offers.Listings.Price" ,
"Offers.Listings.ProgramEligibility.IsPrimeExclusive" ,
"Offers.Listings.ProgramEligibility.IsPrimePantry" ,
"Offers.Listings.Promotions" ,
"Offers.Listings.SavingBasis" ,
"Offers.Summaries.HighestPrice" ,
"Offers.Summaries.LowestPrice" ,
"Offers.Summaries.OfferCount"
]
}
Copy
Response
{
"ItemsResult" : {
"Items" : [
{
"ASIN" : "B0153V644G" ,
"DetailPageURL" : "https://www.amazon.com/dp/B0153V644G?tag=xyz-20&linkCode=ogi&th=1&psc=1" ,
"Offers" : {
"Listings" : [
{
"Availability" : {
"MaxOrderQuantity" : 2 ,
"Message" : "Available now." ,
"MinOrderQuantity" : 1 ,
"Type" : "Now"
} ,
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New" ,
"SubCondition" : {
...
} ,
"ConditionNote" : {
...
}
} ,
"DeliveryInfo" : {
"IsAmazonFulfilled" : false ,
"IsFreeShippingEligible" : false ,
"IsPrimeEligible" : false
} ,
"Id" : "12WqBOCLn5zfcVOfZdnFyx7U%2BqUS%2F8w0iZHvuXP%2F61X6eo3zr8kb%2Fm%2FpTCweNlHAYXT9yQviADTF4XlLSskFNBfuEcFQqAuahUn%2BnEqTWuNI%2BFp%2B8uviSK9W4hUxYp3M6WoendqhEXoTGNndpzuKjA%3D%3D" ,
"IsBuyBoxWinner" : true ,
"MerchantInfo" : {
"DefaultShippingCountry" : "US" ,
"FeedbackCount" : 3670 ,
"FeedbackRating" : 4.5 ,
"Id" : "ATVPDKIKX0DER" ,
"Name" : "Amazon.com"
} ,
"ProgramEligibility" : {
"IsPrimeExclusive" : false ,
"IsPrimePantry" : false
} ,
"ViolatesMAP" : true
}
] ,
"Summaries" : [
{
"Condition" : {
"DisplayValue" : "nuevo" ,
"Label" : "Condición" ,
"Locale" : "es_US" ,
"Value" : "New"
} ,
"OfferCount" : 1
}
]
}
}
]
}
}
Copy
Appendix
Minimum Advertising Price
Some manufacturers have a minimum advertised price (MAP) that can be displayed on Amazon.com. When the Amazon price is lower than the MAP, the manufacturer does not allow the price to be shown until the customer takes further action, such as placing the item in their shopping cart, or in some cases, proceeding to the final checkout stage. Customers need to go to Amazon to see the price on the retail website, but won't be required to purchase the product.