Prev Next

Offers Response Group

The Offers response group is a parent response group that returns the contents of the OfferSummary response group plus, by default, seller and offer listing information. When Condition equals All, up to ten offers are returned sorted by price without regard to Condition. Offer listings are impacted by the values of the MerchantId, DeliveryMethod, and Condition parameters. As such, the total number of offer listings is dependent on the value of these parameters.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by Offers. 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 ElementAncestryDefinition
Amount

OfferSummary/LowestCollectiblePrice/Amount

OfferSummary/LowestNewPrice/Amount

OfferSummary/LowestRefurbishedPrice/Amount

OfferSummary/LowestUsedPrice/Amount

Offers/Offer/OfferListing/Price/Amount

Offers/Offer/OfferListing/SalePrice/Amount

Price in terms of the lowest currency denomination, for example, pennies of the item offered for sale.
Availability Offers/Offer/OfferListing/AvailabilityHow soon the item can be shipped.
AverageFeedbackRating Offers/Offer/Seller/AverageFeedbackRatingCustomer review of an item represented by a number of stars where 5 stars is the highest rating, 0 the lowest. This element contains the average of all customer ratings of the item.
City Offers/Offer/OfferListing/ISPUStoreAddress/CityThe city where the store is that you can pick up the item.
Condition Offers/Offer/OfferAttributes/ConditionThe condition of the item, for example, new, used, collectible, or refurbished.
ConditionNote Offers/Offer/OfferAttributes/ConditionNoteA note that describes the Condition.
Country Offers/Offer/OfferListing/ISPUStoreAddress/CountryThe country where the store is that you can pick up the item.
CurrencyCode

OfferSummary/LowestCollectiblePrice/CurrencyCode

OfferSummary/LowestNewPrice/CurrencyCode

OfferSummary/LowestRefurbishedPrice/CurrencyCode

OfferSummary/LowestUsedPrice/CurrencyCode

Offers/Offer/OfferListing/Price/CurrencyCode

Offers/Offer/OfferListing/SalePrice/CurrencyCode

An abbreviation that specifies the formatting to use when displaying the price.
ExchangeId

Offers/Offer/OfferListing/ExchangeId

OfferSummary/LowestNewPrice/FormattedPrice

OfferSummary/LowestRefurbishedPrice/FormattedPrice

OfferSummary/LowestUsedPrice/FormattedPrice

Offers/Offer/OfferListing/Price/FormattedPrice

Offers/Offer/OfferListing/SalePrice/FormattedPrice

Token that uniquely identifies an offer in the Marketplace. Exchange IDs are available for every item offered by a third-party seller. When using ExchangeId, you must also specify a matching SellerID and ASIN.
FormattedPrice

OfferSummary/LowestCollectiblePrice/FormattedPrice

OfferSummary/LowestNewPrice/FormattedPrice

OfferSummary/LowestRefurbishedPrice/FormattedPrice

OfferSummary/LowestUsedPrice/FormattedPrice

Offers/Offer/OfferListing/Price/FormattedPrice

Offers/Offer/OfferListing/SalePrice/FormattedPrice

The price formatted according to the CurrencyCode parameter.
GlancePage

Offers/Offer/Seller/Glancepage

Offers/Offer/Merchant/GlancePage

URL of a seller's web page. A GlancePage is not returned when the merchant is Amazon.
IsEligibleForSuperSaverShipping Offers/Offer/OfferListing/IsEligibleForSuperSaverShippingSpecifies whether the items is eligible for super saving shipping.
LoyaltyPointsOffers/OfferIn the JP locale only, loyality points are returned. Loyalty points are used to generate sales.
MerchantId Offers/Offer/Merchant/MerchantIdA number that uniquely identifies a merchant
Name Offers/Offer/OfferListing/ISPUStoreAddress/NameThe name of the store where you can pick up the item.
OfferListingId Offers/Offer/OfferListing/OfferListingIdA number that uniquely identifies an offer listing. This number represents a sales offer from a specific merchant.
Quantity OfferListingThe Quantity value is an integer that specifies the number of items in stock. A value of -1 specifies that a Quantity value is unknown.
PostalCode Offers/Offer/OfferListing/ISPUStoreAddress/PostalCodePostal code, such as a postal code.
SellerId Offers/Offer/Seller/SellerIdA number that uniquely identifies a seller.
State Offers/Offer/OfferListing/ISPUStoreAddress/StateThe state in which the store is where the customer will pick up the item when in store pickup (ISPU) has been specified.
SubCondition Offers/Offer/OfferAttributes/SubConditionFurther specifies the Condition of an item, for example, mint, verygood, good. Typically used to qualify the condition of a Used item.
TotalCollectible OfferSummary/TotalCollectibleTotal number of offers whose items are considered collectible.
TotalFeedback Offers/Offer/Seller/TotalFeedbackAverage rating of the customers' feedback about the seller.
TotalNew OfferSummary/TotalNewTotal number of offers whose items are considered new.
TotalOfferPages Offers/TotalOfferPagesNumber of pages of offers. Up to ten offers are returned per page. By default, the first ten offers are returned in the resonse.
TotalOffers Offers/TotalOffersTotal number of offers.
TotalRefurbished OfferSummary/TotalRefurbishedTotal number of offers whose items are considered refurbished.
TotalUsed OfferSummary/TotalUsedTotal number of offers whose items are considered used.

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

In the JP locale only, loyality points are returned. Loyalty points are used to encourage patronage and stimulate sales.

Parent Response Group

The following response groups are parent response groups of Offers.

Child Response Group

The following response groups are child response groups of Offers.

Sample REST Use Case

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

http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService&
AWSAccessKeyId=1V9M7E1ZATWETZDS6W82&
Operation=ItemSearch&
Condition=All&
SearchIndex=Books&
Title=Harry%20Potter&
ResponseGroup=Offers

The following response snippet shows the elements returned by Offers. 

<Item>
  <ASIN>B000AYGDIO</ASIN> 
  <OfferSummary>
    <LowestNewPrice>
      <Amount>24599</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$245.99</FormattedPrice> 
    </LowestNewPrice>
    <LowestUsedPrice>
      <Amount>21995</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$219.95</FormattedPrice> 
    </LowestUsedPrice>
    <LowestRefurbishedPrice>
      <Amount>24995</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$249.95</FormattedPrice> 
    </LowestRefurbishedPrice>
    <TotalNew>31</TotalNew> 
    <TotalUsed>2</TotalUsed> 
    <TotalCollectible>0</TotalCollectible> 
    <TotalRefurbished>2</TotalRefurbished> 
  </OfferSummary>
  <Offers>
    <TotalOffers>35</TotalOffers> 
    <TotalOfferPages>4</TotalOfferPages> 
    <Offer>
      <Seller>
        <SellerId>A34JK8GKGOEZRO</SellerId> 
        <AverageFeedbackRating>4.2</AverageFeedbackRating> 
        <TotalFeedback>40</TotalFeedback> 
      </Seller>
      <OfferAttributes>
        <Condition>Used</Condition> 
        <SubCondition>good</SubCondition> 
        <ConditionNote>Attention! Please read before placing the order. Canon PowerShot SD450 5MP digital cameraThis purchase is only for the camera itself and owner's manual and usb cable only. No other accessory will be included. Camera is in perfect working condition and has some minor scratches on the covers. Ships via Priority Mail w/Tracking Number and insurance</ConditionNote> 
        </OfferAttributes>
          <OfferListing>
          <OfferListingId>f0ctUVF4LATNxeVdXAj5g0j3UbEE%2B1gm%2Fy3ZNjJ%2BrxgGUqPn%2FNy%2BqBcVFoVLQWAugwljO5Zt9zqm865o%2BTk3zGIGDF5oWogFW7frgBq77QgTs%2Baxm%2B2gLQ%3D%3D</OfferListingId> 
<ExchangeId>Y01Y3638197Y4938485</ExchangeId> 
          <Price>
            <Amount>21995</Amount> 
            <CurrencyCode>USD</CurrencyCode> 
            <FormattedPrice>$219.95</FormattedPrice> 
          </Price>
          <Availability>Usually ships in 1 2 business days</Availability> 
          <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping> 
        </OfferListing>
      </Offer>
      <Offer>
        <Seller>
          <SellerId>A1MJDTSASU9FW5</SellerId> 
          <AverageFeedbackRating>4.5</AverageFeedbackRating> 
          <TotalFeedback>666</TotalFeedback> 
        </Seller>
        <OfferAttributes>
          <Condition>Used</Condition> 
          <SubCondition>mint</SubCondition> 
          <ConditionNote>LIKE BRAND NEW WITH ALL ACCESORRIES, WITH WARRANTY 64MB SD CARD INCLUDED</ConditionNote> 
        </OfferAttributes>
        <OfferListing>
          <OfferListingId>i07Pe4OxnTyyzq7BoNNKtHlzST9TnTrQGxDbXsfn3OSua375%2BjDeaGuAcD5Ai%2FLOhiQb%2FksEDCmmT929KpcIRq0t4FE2HjE7S2RQWAkexe6Q4w6tEFTsow%3D%3D</OfferListingId> 
          <ExchangeId>Y01Y1100038Y5252647</ExchangeId> 
          <Price>
            <Amount>22999</Amount> 
            <CurrencyCode>USD</CurrencyCode> 
            <FormattedPrice>$229.99</FormattedPrice> 
          </Price>
          <Availability>Usually ships in 1 2 business days</Availability> 
          <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping> 
        </OfferListing>
      </Offer>
  <Offer>
  <Merchant>
    <MerchantId>AQF1IKH19GQYV</MerchantId> 
    <GlancePage>http://www.amazon.com/gp/help/seller/home.html?seller=AQF1IKH19GQYV</GlancePage> 
  </Merchant>
  <OfferAttributes>
    <Condition>New</Condition> 
    <SubCondition>new</SubCondition> 
  </OfferAttributes>
  <OfferListing>
    <OfferListingId>3dr8Y7th2m18z4aGwdpdVDtc%2BhhZNjFzesYDUjOK8353BWrhSVQrxViAU0Xi9TGdzVQrwrr0TpuM5QQAY8FpzXEusdLg2XtOkcoGnA9vT88rDRPpLKtoZCBBjp7xbFN3</OfferListingId> 
    <ExchangeId>Y11M7003646M2872880</ExchangeId> 
    <Price>
      <Amount>26599</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$265.99</FormattedPrice> 
    </Price>
    <SalePrice>
      <Amount>24599</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$245.99</FormattedPrice> 
    </SalePrice>
    <Availability>Usually ships in 2 3 business days</Availability> 
       <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping> 
    </OfferListing>
  </Offer>
  <Offer>
    <Merchant>
    <MerchantId>ATVPDKIKX0DER</MerchantId> 
    <GlancePage>http://www.amazon.com/gp/help/seller/home.html?seller=ATVPDKIKX0DER</GlancePage> 
    </Merchant>
    <OfferAttributes>
    <Condition>New</Condition> 
  </OfferAttributes>
  <OfferListing>
      <OfferListingId>[Offer listing ID]</OfferListingId> 
  <Price>
    <FormattedPrice>Too low to display</FormattedPrice> 
  </Price>
  <Availability>Usually ships in 24 hours</Availability> 
  <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping> 
</OfferListing>
</Offer>

http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService
    &AWSAccessKeyId=[Your Access Key ID Here]
    &AssociateTag=[Your Associate ID Here]
    &Operation=ItemLookup
    &ItemId=B000AYGDIO
    &MerchantId=All
    &ResponseGroup=Offers
Prev Copyright Information Next