Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

OfferSummary

The OfferSummary response group returns the number of offer listings and the lowest price for each condition type for each item in the response. Condition types are New, Used, Collectible, and Refurbished. For example, this response group returns the lowest price for each Condition:

  • New item

  • Used item

  • Collectible item

  • Refurbished item

Individual offer listings are not returned. The OfferSummary is dependent only on the ASIN parameter and is not affected by the MerchantId or Condition parameters (i.e. the OfferSummary will always be the same for a given ASIN independent of other parameters).

Note

This response group is not returned for Amazon Kindle digital books. An Amazon Kindle ASIN can be verified through the Binding, Format, and ProductTypeName response elements.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by OfferSummary.

OfferSummary also returns the elements that all response groups return, as described in Elements Common to All Response Groups.

Parent Response Group

The following response groups are parent response groups of OfferSummary.

Child Response Group

The following response groups are child response groups of OfferSummary.

  • None

Sample REST Use Case

The following request uses the OfferSummary response group.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate ID]& Operation=ItemLookup& ItemId=B000A3UB2O& ResponseGroup=OfferSummary& Version=2013-08-01 &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by OfferSummary.

Copy
<OfferSummary> <LowestNewPrice> <Amount>801</Amount> <CurrencyCode>USD</CurrencyCode> <FormattedPrice>$8.01</FormattedPrice> </LowestNewPrice> <LowestUsedPrice> <Amount>799</Amount> <CurrencyCode>USD</CurrencyCode> <FormattedPrice>$7.99</FormattedPrice> </LowestUsedPrice> <TotalNew>45</TotalNew> <TotalUsed>20</TotalUsed> <TotalCollectible>0</TotalCollectible> <TotalRefurbished>0</TotalRefurbished> </OfferSummary>