Prev		Next

OfferSummary Response Group

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

New item
Used item
Collectible item
Refurbised item

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

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by OfferSummary. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

Response Element	Ancestry	Definition
Amount	OfferSummary/LowestUsedPrice/Amount OfferSummary/LowestCollectiblePrice/Amount OfferSummary/LowestNewPrice/Amount OfferSummary/LowestRefurbishedPrice/Amount	Price in penny equivalent for items of vavious conditions, including used, collectible, new, and refurbished.
CurrencyCode	OfferSummary/LowestRefurbishedPrice/CurrencyCode OfferSummary/LowestUsedPrice/CurrencyCode OfferSummary/LowestNewPrice/CurrencyCode OfferSummary/LowestCollectiblePrice/CurrencyCode	An abbreviation used to specify the formatting of the price. The formatting varies by locale.
FormattedPrice	OfferSummary/LowestRefurbishedPrice/FormattedPrice OfferSummary/LowestUsedPrice/FormattedPrice OfferSummary/LowestCollectiblePrice/FormattedPrice OfferSummary/LowestNewPrice/FormattedPrice	The price formatted according to CurrencyCode that is ready to present to the customer.
`TotalCollectible`	OfferSummary/TotalCollectible	The total number of collectible items for sale.
`TotalNew`	OfferSummary/TotalNew	The total number of new items for sale.
`TotalRefurbished`	OfferSummary/TotalRefurbished	The total number of refurbished items for sale.
`TotalUsed`	OfferSummary/TotalUsed	The total number of used items for sale.

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

Parent Response Group

The following response groups are parent response groups of OfferSummary.

None

Child Response Group

The following response groups are child response groups of OfferSummary.

None

Sample REST Use Case

The folllowing request was used to illustrate the XML response elements returned by OfferSummary.

http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService&
AWSAccessKeyId=[Access Key ID]&
Operation=ItemLookup&
ItemId=B000A3UB2O&
ResponseGroup=OfferSummary

Sample Response Snippet

The following response snippet shows the elements returned by OfferSummary.

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