Did this page help you? Yes No Tell us about it...

Offers Response Group

The Offers response group is a parent response group that returns the contents of the OfferSummary Response Group response group plus, by default, offer listing information. The Offers response group can take Condition and MerchantId as an optional input parameter. By default, the offer for Buy Box winner is returned, which is an item listed in the box on an item's detail page that enables you to add an item to a shopping cart.

The only valid values for MerchantId are Amazon, to get the Amazon offer for an item if it exists, and All, which is the default value. For reasons of reverse compatibility, the Offers response group ignores a MerchantID value of Featured or Featured Buy Box Winner and returns the default value.

The following table shows the expected behavior of the Offers response group for various input parameters:

Optional Input Parameters		Offer(s) Data Returned by the API
Condition	MerchantId	Offer(s) Data Returned by the API
(Default)	(Default)	Buy Box Winner if it exists [OR] Lowest priced new offer.
(Default)	Amazon	Amazon offer
(Default)	Any other value	Error: invalid value
Used, New, Refurbished, or Collectible	(Default) or All	Lowest priced offer for given condition
Used, New, Refurbished, or Collectible	Amazon	Amazon offer
Used, New, Refurbished, or Collectible	Any other value	Error: invalid value
All	(Default)	Lowest priced offer for each condition
All	Amazon	Amazon offer
(Default)	Any other value	Error: invalid value

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

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

Loyalty Points

In the JP locale only, loyalty 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.

None

Child Response Group

The following response groups are child response groups of Offers.

OfferSummary

Sample REST Use Case

The following request illustrates the XML response elements returned by Offers.

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=1VEXAMPLEDS6W82&
Operation=ItemSearch&
Condition=All&
SearchIndex=Books&
Title=Harry%20Potter&
ResponseGroup=Offers&
Version=2011-08-01
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by Offers.

<Item>
  <ASIN>047061529X</ASIN>
  <OfferSummary>
    <LowestNewPrice>
      <Amount>1025</Amount>
      <CurrencyCode>USD</CurrencyCode>
      <FormattedPrice>$10.25</FormattedPrice>
    </LowestNewPrice>
    <LowestUsedPrice>
      <Amount>1110</Amount>
      <CurrencyCode>USD</CurrencyCode>
      <FormattedPrice>$11.10</FormattedPrice>
    </LowestUsedPrice>
    <TotalNew>37</TotalNew>
    <TotalUsed>12</TotalUsed>
    <TotalCollectible>0</TotalCollectible>
    <TotalRefurbished>0</TotalRefurbished>
  </OfferSummary>
  <Offers>
    <TotalOffers>2</TotalOffers>
    <TotalOfferPages>1</TotalOfferPages>
    <MoreOffersUrl>http://www.amazon.com/gp/offer-listing/047061529X/?SubscriptionId=0TMGJB9ZR3ERMA342002&ie=UTF8&tag=adrpik-20&creative=386001&camp=2025&linkCode=xm2 </MoreOffersUrl>
    <Offer>
      <OfferAttributes>
        <Condition>New</Condition>
      </OfferAttributes>
      <OfferListing>
        <OfferListingId>6vZH%2FR4dOoabV7sTSv3vC0Np5xK1c8MKOhAl5HYbCIJhxOLlJw1O2AM6mLYyVhjnI8s2gMkx7yq%2F%2BEC7yKPWkQTqhVhFBeUDm71EdpaYwrXpppfcAL1yPzyQFkOuK6MsK8aLPSNSWVs%3D </OfferListingId>
        <Price>
          <Amount>1025</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$10.25</FormattedPrice>
        </Price>
        <AmountSaved>
          <Amount>974</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$9.74</FormattedPrice>
        </AmountSaved>
        <PercentageSaved>49</PercentageSaved>
        <Availability>Usually ships in 1-2 business days</Availability>
        <AvailabilityAttributes>
          <AvailabilityType>now</AvailabilityType>
          <MinimumHours>24</MinimumHours>
          <MaximumHours>48</MaximumHours>
        </AvailabilityAttributes>
        <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping>
      </OfferListing>
    </Offer>

    <Offer>
      <OfferAttributes>
        <Condition>Used</Condition>
      </OfferAttributes>
      <OfferListing>
        <OfferListingId>uXUlLeu7rH5t3ogkZJ%2Bd11tWCsdsj5kHhjoscRF1D1GuBuDwCyrz0XyR%2BTEOJO7PgpfwLjtX4ojhbXeHZgM0Br4DiWsPhNZTduzvYC8zLgG0z1e%2FgYiiuuR0wTyKqssY6ncHyVjZK1A%3D </OfferListingId>
        <Price>
          <Amount>1110</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$11.10</FormattedPrice>
        </Price>
        <AmountSaved>
          <Amount>889</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$8.89</FormattedPrice>
        </AmountSaved>
        <PercentageSaved>44</PercentageSaved>
        <Availability>Usually ships in 1-2 business days</Availability>
        <AvailabilityAttributes>
          <AvailabilityType>now</AvailabilityType>
          <MinimumHours>24</MinimumHours>
          <MaximumHours>48</MaximumHours>
        </AvailabilityAttributes>
        <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping>
      </OfferListing>
    </Offer>
  </Offers>
</Item>

The Request that Generated the Response (REST)

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=<replaceable>
<replaceable>[AWS Access Key ID]</replaceable>
</replaceable>&
AssociateTag=<replaceable>
<replaceable>[Associate ID]</replaceable>
</replaceable>&
Operation=ItemLookup&
ItemId=B000AYGDIO&
ResponseGroup=Offers
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

Document Conventions
Terms of Use

Did this page help you? Yes No Tell us about it...