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
      }
    ],
    ...
  }
}

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": {
          ...
        }
      }
    ],
    ...
  }
}

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,
        ...
      }
    ]
  }
}

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,
        ...
      }
    ]
  }
}

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,
        ...
      }
    ]
  }
}

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,
        ...
      }
    ]
  }
}

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,
        ...
    ]
  }
}

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,
        ...
    ]
  }
}

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,
        ...
    ]
  }
}

ProgramEligibility

Attribute Name Type Description
IsPrimeExclusive Boolean Specifies whether a product is associated with prime exclusive members
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,
        ...
    ]
  }
}

Promotions

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 benefited
Valid 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,
        ...
    ]
  }
}

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,
        ...
      }
    ]
  }
}

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)"
        },
        ...
      }
    ]
  }
}

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)"
        },
        ...
      }
    ]
  }
}

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,
        ...
      }
    ]
  }
}

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,
        ...
      }
    ]
  }
}

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"
  ]
}

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
            }
          ]
        }
      }
    ]
  }
}

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"
  ]
}

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
            }
          ]
        }
      }
    ]
  }
}

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"
  ]
}

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
            }
          ]
        }
      }
    ]
  }
}

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.

results matching ""

    No results matching ""